
MCP Notes Server

2025.03.15
0
Python笔记管理MCP协议其它
MCP Notes Server 是一个基于 Message Coordination Protocol (MCP) 的简单服务器,用于管理和访问存储在 `~/DocumentationGenerator/notes/` 目录下的笔记。该服务器提供了基本的笔记管理功能,包括列出所有笔记、获取特定笔记以及搜索笔记内容。
View on GitHub
Overview
基本能力
产品定位
MCP Notes Server 是一个轻量级的笔记管理服务,通过 MCP 协议提供对本地存储笔记的访问和管理功能。
核心功能
- 列出所有笔记:通过
list_notes()
命令获取所有笔记的列表。 - 获取特定笔记:通过
get_note(note_name)
命令获取指定名称的笔记内容。 - 搜索笔记:通过
search(query, note_name=None)
命令根据查询字符串搜索笔记内容。
适用场景
- 个人笔记管理:用于存储和管理个人笔记,支持快速检索。
- 团队协作:团队成员可以通过 MCP 协议共享和访问笔记内容。
- 开发辅助:开发者可以将笔记作为文档或日志存储,方便后续查阅。
工具列表
- MCPClient:用于连接 MCP 服务器并调用其提供的功能,如列出笔记、获取笔记和搜索笔记。
常见问题解答
- 如何启动服务器?
- 运行
python notes.py
命令即可启动服务器。 - 服务器默认监听地址是什么?
- 服务器默认监听
http://0.0.0.0:8000
。 - 笔记的存储格式是什么?
- 笔记以 JSON 格式存储,包含分类、摘要、标签和消息内容。
使用教程
使用依赖
- 确保已安装 Python 3.7+。
- 创建虚拟环境:
python -m venv venv
- 激活虚拟环境:
- macOS/Linux:
source venv/bin/activate
- Windows:
venv\Scripts\activate
- 安装依赖:
pip install -r requirements.txt
安装教程
- 克隆项目或下载源代码。
- 按照上述依赖步骤配置环境。
- 启动服务器:
python notes.py
调试方式
- 确保服务器已启动并监听
http://0.0.0.0:8000
。 - 使用 MCPClient 连接服务器并测试功能:
python from mcp.client import MCPClient client = MCPClient("http://localhost:8000") notes = client.call("notes.list_notes") print(notes)
许可证
None