MCP Notes Server

MCP Notes Server

site icon
2025.03.15 0
Python笔记管理MCP协议其它
MCP Notes Server 是一个基于 Message Coordination Protocol (MCP) 的简单服务器,用于管理和访问存储在 `~/DocumentationGenerator/notes/` 目录下的笔记。该服务器提供了基本的笔记管理功能,包括列出所有笔记、获取特定笔记以及搜索笔记内容。
View on GitHub

Overview

基本能力

产品定位

MCP Notes Server 是一个轻量级的笔记管理服务,通过 MCP 协议提供对本地存储笔记的访问和管理功能。

核心功能

  1. 列出所有笔记:通过 list_notes() 命令获取所有笔记的列表。
  2. 获取特定笔记:通过 get_note(note_name) 命令获取指定名称的笔记内容。
  3. 搜索笔记:通过 search(query, note_name=None) 命令根据查询字符串搜索笔记内容。

适用场景

  1. 个人笔记管理:用于存储和管理个人笔记,支持快速检索。
  2. 团队协作:团队成员可以通过 MCP 协议共享和访问笔记内容。
  3. 开发辅助:开发者可以将笔记作为文档或日志存储,方便后续查阅。

工具列表

  1. MCPClient:用于连接 MCP 服务器并调用其提供的功能,如列出笔记、获取笔记和搜索笔记。

常见问题解答

  1. 如何启动服务器?
  2. 运行 python notes.py 命令即可启动服务器。
  3. 服务器默认监听地址是什么?
  4. 服务器默认监听 http://0.0.0.0:8000
  5. 笔记的存储格式是什么?
  6. 笔记以 JSON 格式存储,包含分类、摘要、标签和消息内容。

使用教程

使用依赖

  1. 确保已安装 Python 3.7+。
  2. 创建虚拟环境: python -m venv venv
  3. 激活虚拟环境:
  4. macOS/Linux:source venv/bin/activate
  5. Windows:venv\Scripts\activate
  6. 安装依赖: pip install -r requirements.txt

安装教程

  1. 克隆项目或下载源代码。
  2. 按照上述依赖步骤配置环境。
  3. 启动服务器: python notes.py

调试方式

  1. 确保服务器已启动并监听 http://0.0.0.0:8000
  2. 使用 MCPClient 连接服务器并测试功能: python from mcp.client import MCPClient client = MCPClient("http://localhost:8000") notes = client.call("notes.list_notes") print(notes)

许可证

None