MCP 注释服务器

用于管理具有持久存储的笔记的模型上下文协议 (MCP) 服务器实现。

特征

• 创建、阅读、更新和删除笔记

• 使用 JSON 进行持久存储

• 创建和修改的时间戳跟踪

• 通过提示进行笔记总结

• 使用 note:// URI 方案的基于资源的访问

安装

通过 Smithery 安装

要通过Smithery自动安装 Claude Desktop 的笔记：

手动安装

1. 确保安装了 Python 3.10 或更高版本

2. 创建虚拟环境：

   python -m venv .venv # On Unix/MacOS: source .venv/bin/activate # On Windows: .venv\Scripts\activate

3. 安装要求：

   pip install MCP

项目结构

可用工具

• add-note ：创建新注释

• list-all-notes ：显示所有存储的笔记

• update-note ：修改现有注释

• delete-note ：删除注释

用法

1. 启动服务器：

   mcp install src/notes mcp start Notes

2. 示例操作：

   # Create a note await client.call_tool("add-note", { "name": "example", "content": "This is a test note" }) # List all notes await client.call_tool("list-all-notes") # Update a note await client.call_tool("update-note", { "name": "example", "content": "Updated content" }) # Delete a note await client.call_tool("delete-note", { "name": "example" })

贮存

笔记存储在notes_storage.json中，结构如下：

资源访问

可以使用note:// URI 方案将注释作为资源进行访问：

• 列出资源：返回所有可用的注释作为资源

• 读取资源：使用note://internal/note_name访问特定笔记

提示生成

服务器包含一个用于笔记摘要的提示生成功能：

• 支持简短和详细的摘要

• 为语言模型输入格式化注释

• 可通过“summarize-notes”提示获取

发展

要修改或扩展服务器：

1. 克隆存储库

2. 安装开发依赖项

3. 在适当的模块中进行更改

4. 部署前彻底测试

测试

测试应涵盖：

• 基本 CRUD 操作

• 多条笔记处理

• 错误案例

• 资源访问

• 提示生成

执照

[在此添加您的许可证]