MCP 笔记服务器

这是一个 MCP (模型上下文协议) 服务器的实现，用于管理给定目录中的 Markdown 笔记。该服务器提供使用 stdio 传输创建、读取和更新 Markdown 笔记的功能。

功能

• 创建新的 Markdown 笔记
• 读取现有的 Markdown 笔记
• 更新现有的 Markdown 笔记
• 列出笔记库中的所有笔记
• 自动管理指定目录中的文件
• 适当的错误处理和日志记录
• 跟踪笔记的创建和修改时间戳
• 所有操作的 JSON Schema 验证

服务器能力

该服务器实现了以下能力：

• 版本：1.0.0
• 名称：Notes MCP Server
• 描述：用于管理给定目录中的 Markdown 笔记的服务器
• 支持的传输方式：stdio

资源

该服务器提供以下资源：

• 属性：
  • path: 笔记库的路径
  • note_count: 笔记库中笔记的总数

工具

该服务器实现了以下 MCP 工具：

create_note

创建一个新的 Markdown 笔记。

参数：

• title: 笔记的标题（必需）
• content: 笔记的内容（可选，默认为空字符串）

返回：

• filename: 创建的文件名
• path: 创建文件的完整路径
• created_at: 创建的 ISO 时间戳

read_note

读取现有的 Markdown 笔记。

参数：

• title: 要读取的笔记的标题（必需）

返回：

• title: 笔记的标题
• content: 笔记的内容
• path: 文件的完整路径
• created_at: 创建的 ISO 时间戳
• modified_at: 最后修改的 ISO 时间戳

update_note

更新现有的 Markdown 笔记。

参数：

• title: 要更新的笔记的标题（必需）
• content: 笔记的新内容（可选，默认为空字符串）

返回：

• filename: 更新的文件名
• path: 文件的完整路径
• updated_at: 更新的 ISO 时间戳

list_notes

列出笔记库中的所有 Markdown 笔记。

参数：无

返回：

• notes: 笔记对象数组，每个对象包含：
  • title: 笔记的标题
  • path: 文件的完整路径
  • created_at: 创建的 ISO 时间戳
  • modified_at: 最后修改的 ISO 时间戳
• total: 笔记总数

设置

1. 安装所需的依赖项：

pip install -r requirements.txt

2. 配置服务器以在 main.py 的第 110 行的给定目录中工作，方法是编辑 notes_dir 属性：

3. 配置 Cursor 以使用 MCP 服务器：

   • 配置文件位于 .cursor/mcp.json
   • Cursor 将自动检测并使用此配置
   • 服务器配置为使用 Python 和正确的 UTF-8 编码运行

运行服务器

当 Cursor 加载项目时，服务器将自动启动。您也可以手动运行它：

python main.py

服务器将启动并监听通过 stdin/stdout 发送的 MCP 请求。所有操作都使用适当的级别（info/error）记录，以便进行调试和监控。

错误处理

服务器针对各种场景实现了适当的错误处理：

• 缺少必需的参数
• 文件已存在
• 文件未找到
• 常规异常

所有错误都会被记录，并返回适当的错误代码和消息。

配置详情

MCP 服务器在 .cursor/mcp.json 中配置，具有以下设置：

{
  "mcpServers": {
    "notes-server": {
      "command": "python",
      "args": ["main.py"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

要将 MCP 添加为全局使用，请将其添加到用户目录中的 .cursor 文件夹中，或者转到 Cursor 设置 -> MCP -> 添加新的全局 MCP 服务器 -> 将此项目中的 mcp.json 复制/粘贴到新文件中 -> 更新 args 以指向 main.py

此配置：

• 将服务器命名为 "notes-server"
• 使用 Python 运行服务器
• 设置 UTF-8 编码以正确处理字符