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. 安装所需的依赖项：
   bash
   pip install -r requirements.txt

2. 配置服务器以在main.py的第110行指定的目录中工作，通过编辑notes_dir属性来完成配置：

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

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

运行服务器

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

bash
python main.py

服务器将启动并通过stdin/stdout监听MCP请求。所有操作都以适当级别（信息/错误）进行日志记录，以便调试和监控。

错误处理

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

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

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

配置详情

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

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 编码以正确处理字符