MCP add notes

FastAPI MCP Notes服务器

基于FastAPI的模型上下文协议（MCP）服务器，允许客户端添加和管理具有文件名和内容的注释。

概述

此MCP服务器为创建和存储笔记提供了一个简单的界面。客户端可以发送带有文件名和内容的笔记，然后将其存储在本地可配置的目录中。

特性

• 添加注释：使用自定义文件名和内容创建注释
• FastAPI后端：建立在FastAPI之上，实现高性能和自动化的API文档
• MCP集成：遵循模型上下文协议，与MCP客户端无缝集成
• 异步文件操作：具有文件锁定的非阻塞文件I/O，以实现并发安全
• 基于环境的配置：可通过环境变量配置笔记目录

技术栈

• 快速API：用于构建API的现代快速web框架
• Python 3.12+：核心编程语言
• FastMCP：用于标准化通信的MCP协议实现
• aiofiles：异步文件操作
• python dotenv：环境变量管理

安装

1. 克隆存储库 （或导航到项目目录）

1. 安装依赖项 使用紫外线：

uv sync

1. 配置环境变量:

# Copy the example environment file
cp .env.example .env

# Edit .env to customize the notes directory (optional)
# Default: ~/.mcp-notes

配置

服务器使用环境变量进行配置。创建一个 .env 项目根目录中的文件：

# Directory where notes will be stored
NOTES_DIR=~/.mcp-notes

您可以自定义 NOTES_DIR 走你喜欢的任何一条路。如果目录不存在，将自动创建。

用法

运行服务器

# Start the FastAPI server
uvicorn main:app --reload

服务器将在以下时间启动并可用：

• HTTP API: http://localhost:8000
• MCP端点: http://localhost:8000/mcp
• 健康检查: http://localhost:8000/health
• API文件: http://localhost:8000/docs

使用Claude代码

此服务器在Claude Code中配置为MCP服务器 ~/.claude/mcp_servers.json:

{
  "notes-server": {
    "type": "sse",
    "url": "http://localhost:8000/mcp"
  }
}

要使用：

1. 启动服务器： uvicorn main:app --reload
2. 重新启动Claude Code或重新加载MCP服务器
3. 这 write_to_file 该工具将在Claude Code中可用

可用的MCP工具：

• write_to_file(file_name, file_content) -将笔记写入配置的笔记目录中的文件

API终点

健康检查

GET /health

返回服务器状态。

写笔记（HTTP）

POST /write-note
Content-Type: application/json

{
  "file_name": "my-note",
  "file_content": "This is my note content"
}

MCP工具：write_to_file

服务器公开了一个MCP工具 write_to_file MCP客户端可以调用：

• 文件名：笔记文件的名称（无扩展名）
• 文件内容：写笔记的内容

发展

本项目使用：

• 快速API 对于web框架
• FastMCP 用于MCP协议实现
• aiofiles 用于异步文件操作
• 文件锁定 （asyncio.Lock）以防止并发写入期间出现竞争情况

项目结构

.
├── main.py           # Main FastAPI application
├── schemas.py        # Pydantic models for request/response
├── .env              # Environment configuration (not in git)
├── .env.example      # Example environment configuration
└── pyproject.toml    # Project dependencies

许可证

\[在此处添加您的许可证\]