article
README
🚀 beeper_mcp MCP服务器
beeper_mcp MCP服务器是一个用于与链交互的简单工具,它实现了笔记存储、提示语生成和笔记添加等功能,为用户提供便捷的链交互体验。
✨ 主要特性
资源
该服务器构建了一个简易的笔记存储系统,具备以下特点:
- 采用自定义的note:// URI方案,方便用户访问单个笔记。
- 每个笔记资源涵盖名称、描述,并采用text/plain MIME类型。
提示语
服务器提供了一个实用的提示功能:
- summarize - notes:能够生成所有存储笔记的摘要。
- 支持“风格”可选参数,可控制摘要的详细程度(简洁/详细)。
- 根据用户的风格偏好,生成包含所有当前笔记内容的提示。
工具
服务器实现了一个便捷的工具:
- add - note:可向服务器添加新的笔记。
- 要求接受“名称”和“内容”作为必需的字符串参数。
- 添加后会更新服务器状态,并及时通知客户端资源变化。
📦 安装指南
在Claude Desktop上的安装
- MacOS系统:配置文件路径为
~/Library/Application\ 支持/Claude/claude_desktop_config.json。 - Windows系统:配置文件路径为%APPDATA%/Claude/claude_desktop_config.json%。
开发/未发布的服务器配置
``` "mcpServers": { "beeper_mcp": { "command": "uv", "args": [ "--directory", "/Users/pan/work/openos/beeper/beeper_mcp", "run", "beeper_mcp" ] } } ```已发布的服务器配置
``` "mcpServers": { "beeper_mcp": { "command": "uvx", "args": [ "beeper_mcp" ] } } ```💻 使用示例
构建与发布
为了准备分发,可按以下步骤操作:
同步依赖项并更新锁定文件
uv sync
构建发行版本
uv build
此操作会在dist/目录中创建源代码和轮格式发行版。
发布到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 /Users/pan/work/openos/beeper/beeper_mcp run beeper-mcp
启动后,Inspector会显示一个URL,你可以在浏览器中访问该URL开始调试。
扫码联系在线客服