MCP Notes Server
MCP 注释服务器
用于管理具有持久存储的笔记的模型上下文协议 (MCP) 服务器实现。
特征
创建、阅读、更新和删除笔记
使用 JSON 进行持久存储
创建和修改的时间戳跟踪
通过提示进行笔记总结
使用 note:// URI 方案的基于资源的访问
Related MCP server: Beeper MCP Note Server
安装
通过 Smithery 安装
要通过Smithery自动安装 Claude Desktop 的笔记:
npx -y @smithery/cli install notes --client claude手动安装
确保安装了 Python 3.10 或更高版本
创建虚拟环境:
python -m venv .venv # On Unix/MacOS: source .venv/bin/activate # On Windows: .venv\Scripts\activate安装要求:
pip install MCP
项目结构
notes/
├── __init__.py # Package initialization
├── server.py # Main server implementation
├── storage.py # Note persistence layer
├── resources.py # Resource handling (note:// URIs)
├── prompts.py # LLM prompt generation
└── tools/ # Server tools
├── __init__.py # Tools package initialization
├── list_tools.py # Tool listing functionality
└── handle_tools.py # Tool handling implementation可用工具
add-note:创建新注释list-all-notes:显示所有存储的笔记update-note:修改现有注释delete-note:删除注释
用法
启动服务器:
mcp install src/notes mcp start Notes示例操作:
# 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_name": {
"content": "Note content",
"created_at": "2025-01-12T11:28:16.721704",
"modified_at": "2025-01-12T11:28:16.721704"
}
}资源访问
可以使用note:// URI 方案将注释作为资源进行访问:
列出资源:返回所有可用的注释作为资源
读取资源:使用
note://internal/note_name访问特定笔记
提示生成
服务器包含一个用于笔记摘要的提示生成功能:
支持简短和详细的摘要
为语言模型输入格式化注释
可通过“summarize-notes”提示获取
发展
要修改或扩展服务器:
克隆存储库
安装开发依赖项
在适当的模块中进行更改
部署前彻底测试
测试
测试应涵盖:
基本 CRUD 操作
多条笔记处理
错误案例
资源访问
提示生成
执照
[在此添加您的许可证]
Available Tools
4 toolsadd-noteC
Create a new note
Inputs: content (required), name (required).
delete-noteC
Delete an existing note
Inputs: name (required).
list-all-notesB
Read all stored notes
Inputs: no named parameters.
update-noteC
Update an existing note
Inputs: content (required), name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose targeting specific CRUD operations on notes: add-note for creation, delete-note for deletion, list-all-notes for reading all, and update-note for updates. There is no overlap in functionality, making tool selection unambiguous.
The tools follow a mostly consistent verb-noun pattern (add-note, delete-note, update-note), but list-all-notes deviates slightly by including 'all'. This minor inconsistency does not significantly hinder readability or predictability.
With 4 tools, the server is well-scoped for a notes management system, covering the essential CRUD operations. Each tool earns its place without being overly sparse or bloated, fitting the typical 3-15 tool range appropriately.
The tool set provides complete CRUD coverage for the notes domain: create (add-note), read (list-all-notes), update (update-note), and delete (delete-note). There are no obvious gaps, allowing agents to handle full note lifecycles without dead ends.
Maintenance
Related MCP Connectors
An MCP server that used to create notes
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Notes, files, GitHub, and Drive through one MCP connection.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA simple note-taking MCP server that allows storing and summarizing notes with custom URI schemes and provides functionality to add notes and generate summaries with different detail levels.5-
- FlicenseNot gradedqualityDmaintenanceA simple MCP server for creating and managing notes with support for summarization functionality.1-
- FlicenseBqualityDmaintenanceA simple note-taking MCP server that stores notes and can generate summaries of stored content.4-
- FlicenseNot gradedqualityNot gradedmaintenanceA simple MCP server that implements a note storage system allowing users to add and summarize notes with customizable detail levels.3-