beeper_mcp MCP server

基本能力

产品定位

beeper-mcp-server 是一个用于与链交互的 MCP 服务器，主要功能是提供简单的笔记存储系统和笔记摘要生成。

核心功能

1. 笔记存储系统：
2. 自定义 note:// URI 方案访问单个笔记
3. 每个笔记资源有名称、描述和文本/纯文本 MIME 类型
4. 笔记摘要生成：
5. 提供 summarize-notes 提示，生成所有存储笔记的摘要
6. 可选的 "style" 参数控制详细程度（brief/detailed）
7. 工具：
8. add-note 工具：添加新笔记到服务器
   • 需要 "name" 和 "content" 作为必填字符串参数
   • 更新服务器状态并通知客户端资源更改

适用场景

1. 需要简单笔记存储和管理的应用
2. 需要自动生成笔记摘要的场景
3. 需要与链交互的应用

使用教程

使用依赖

无明确前置依赖，但需要安装 Claude Desktop。

安装教程

Claude Desktop 配置

• MacOS: 配置文件位于 ~/Library/Application\ Support/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"
    ]
  }
}

调试方式

推荐使用 MCP Inspector 进行调试。

启动 MCP Inspector 的命令：

npx @modelcontextprotocol/inspector uv --directory /Users/pan/work/openos/beeper/beeper_mcp run beeper-mcp

启动后，Inspector 将显示一个可以在浏览器中访问的 URL 以开始调试。

开发

构建和发布

1. 同步依赖并更新锁文件：

uv sync

1. 构建包分发：

uv build

这将在 dist/ 目录中创建源和轮分发。

1. 发布到 PyPI：

uv publish

注意：需要通过环境变量或命令标志设置 PyPI 凭据： - Token: --token 或 UV_PUBLISH_TOKEN - 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

常见问题解答

1. 如何调试 MCP 服务器？
2. 推荐使用 MCP Inspector 进行调试。

3. 启动命令：npx @modelcontextprotocol/inspector uv --directory /path/to/beeper_mcp run beeper-mcp

4. 如何添加新笔记？

5. 使用 add-note 工具，提供 "name" 和 "content" 参数。

6. 如何生成笔记摘要？

7. 使用 summarize-notes 提示，可选 "style" 参数控制详细程度。

许可证

None