MCP Notes Server

基本能力

产品定位

MCP Notes Server 是一个专注于笔记管理的服务，提供创建、读取、更新和删除笔记的功能，并支持笔记的持久化存储和资源访问。

核心功能

• 创建、读取、更新和删除笔记
• 使用 JSON 进行持久化存储
• 跟踪笔记的创建和修改时间戳
• 通过提示生成笔记摘要
• 使用 note:// URI 方案进行基于资源的访问

适用场景

• 个人笔记管理
• 团队协作中的信息记录
• 需要持久化存储的笔记应用
• 需要与语言模型集成的笔记系统

工具列表

• add-note: 创建新笔记
• list-all-notes: 显示所有存储的笔记
• update-note: 修改现有笔记
• delete-note: 删除笔记

常见问题解答

• 笔记存储在 notes_storage.json 文件中
• 笔记可以通过 note://internal/note_name 格式的 URI 访问
• 支持生成笔记摘要的提示

使用教程

使用依赖

1. 确保已安装 Python 3.10 或更高版本
2. 创建虚拟环境: ```bash python -m venv .venv

# On Unix/MacOS: source .venv/bin/activate

# On Windows: .venv\Scripts\activate ```

安装教程

通过 Smithery 安装

npx -y @smithery/cli install notes --client claude

手动安装

1. 安装 MCP: bash pip install MCP
2. 启动服务器: bash mcp install src/notes mcp start Notes

调试方式

示例操作:

# 创建笔记
await client.call_tool("add-note", {
    "name": "example",
    "content": "This is a test note"
})

# 列出所有笔记
await client.call_tool("list-all-notes")

# 更新笔记
await client.call_tool("update-note", {
    "name": "example",
    "content": "Updated content"
})

# 删除笔记
await client.call_tool("delete-note", {
    "name": "example"
})

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。