MCP Notes Server

MCP Notes Server

site icon
2025.03.25 1
Python笔记管理Markdown 文件管理内容生成
MCP Notes Server 是一个基于 Model Context Protocol (MCP) 的服务,用于管理指定目录中的 Markdown 笔记。该服务提供了创建、读取和更新 Markdown 笔记的功能,支持通过 stdio 传输协议进行通信。
View on GitHub

Overview

基本能力

产品定位

MCP Notes Server 是一个专注于 Markdown 笔记管理的服务,适用于需要高效管理和操作 Markdown 文件的场景。

核心功能

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

适用场景

  • 个人笔记管理
  • 团队协作中的文档共享
  • 需要自动化管理 Markdown 文件的开发项目

工具列表

  1. create_note: 创建新的 Markdown 笔记
  2. 参数: title (必填), content (可选)
  3. 返回: 文件名、文件路径、创建时间
  4. read_note: 读取现有的 Markdown 笔记
  5. 参数: title (必填)
  6. 返回: 标题、内容、文件路径、创建时间、修改时间
  7. update_note: 更新现有的 Markdown 笔记
  8. 参数: title (必填), content (可选)
  9. 返回: 文件名、文件路径、更新时间
  10. list_notes: 列出保险库中的所有笔记
  11. 参数: 无
  12. 返回: 笔记列表(包含标题、路径、创建时间、修改时间)、笔记总数

常见问题解答

  • 错误处理包括:缺少必要参数、文件已存在、文件未找到、一般异常
  • 所有错误都会记录并返回适当的错误代码和消息

使用教程

使用依赖

安装所需的依赖项:

pip install -r requirements.txt

安装教程

  1. 配置服务器以在给定目录中工作,编辑 main.py 文件中的 notes_dir 属性(第110行)。
  2. 配置 Cursor 以使用 MCP 服务器:
  3. 配置文件位于 .cursor/mcp.json
  4. Cursor 将自动检测并使用此配置
  5. 服务器配置为使用 Python 和正确的 UTF-8 编码

调试方式

手动运行服务器:

python main.py

服务器将启动并通过 stdin/stdout 监听 MCP 请求。所有操作都会记录适当的级别(info/error)以供调试和监控。

许可证

None