关于 mcp-server MCP server
这是一个用于简单笔记存储的基础 MCP 服务,面向需要向 MCP 客户端提供笔记和摘要提示词的场景。它通过资源、工具和提示词覆盖添加、读取及汇总笔记。
主要功能
- 01添加并更新笔记
- 02通过 note:// 访问笔记
- 03笔记资源变更通知
- 04生成笔记摘要提示词
适用场景
- 01将笔记保存到 MCP 服务
- 02按名称读取单条笔记
- 03汇总当前存储的笔记
- 04调整摘要的简略或详细程度
MCP 相关
该服务向 MCP 客户端提供 note:// 笔记资源、添加笔记工具和 summarize-notes 提示词。添加笔记后会更新服务状态并通知客户端资源变更。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
mcp-server MCP 服务
基础 MCP 服务
组件
资源
服务器实现了一个简单的笔记存储系统:
- 使用自定义的 note:// URI 方案访问单条笔记
- 每个笔记资源都有名称、描述和 text/plain MIME 类型
提示词
服务器提供一个提示词:
- summarize-notes:汇总所有已存储的笔记
- 可选的「style」参数,用于控制详细程度(简短/详细)
- 生成的提示词会结合所有当前笔记和风格偏好
工具
服务器实现了一个工具:
- add-note:向服务器添加新笔记
- 接受「name」和「content」作为必需的字符串参数
- 更新服务器状态,并通知客户端资源变更
配置
[TODO: 添加特定于此实现的配置详情]
快速入门
安装
Claude Desktop
MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:%APPDATA%/Claude/claude_desktop_config.json
开发/未发布服务器配置
``` "mcpServers": { "mcp-server": { "command": "uv", "args": [ "--directory", "C:\Users\marti\Documents\Github\MyGithub\mcp-server", "run", "mcp-server" ] } } ```已发布服务器配置
``` "mcpServers": { "mcp-server": { "command": "uvx", "args": [ "mcp-server" ] } } ```开发
构建和发布
准备分发软件包:
- 同步依赖项并更新锁文件:
uv sync
- 构建软件包分发文件:
uv build
这将在 dist/ 目录中创建源代码分发包和 wheel 分发包。
- 发布到 PyPI:
uv publish
注意:你需要通过环境变量或命令标志设置 PyPI 凭据:
- 令牌:
--token或UV_PUBLISH_TOKEN - 或用户名/密码:
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于 MCP 服务通过 stdio 运行,调试可能颇具挑战。为了获得最佳调试体验,我们强烈建议使用 MCP Inspector。
你可以通过 npm 使用以下命令启动 MCP Inspector:
npx @modelcontextprotocol/inspector uv --directory C:\Users\marti\Documents\Github\MyGithub\mcp-server run mcp-server
启动后,Inspector 会显示一个 URL,你可以在浏览器中访问该地址以开始调试。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。