项目简介
Orbit 是一个 MCP (Model Context Protocol) 服务器,专注于个人联系人管理。它可以作为 Claude Desktop 等 LLM 客户端的后端,提供联系人数据和相关工具,增强 LLM 的上下文理解和交互能力。
主要功能点
- 联系人信息管理: 托管和管理用户的个人联系人数据。
- 联系人信息查询: 支持通过自然语言查询联系人信息,例如 "What do you know about [🧍]?", "When did I meet [🧍]?"。
- 联系人信息编辑: 允许 LLM 客户端更新联系人信息,例如更新联系频率、添加备注、修改工作信息等。
- 事件提醒: 提供生日、纪念日、计划的联系提醒等功能。
- 工具集成: 通过 MCP 协议向 LLM 客户端暴露联系人相关的工具,例如发送邮件、发起对话等。
安装步骤
- 双击下载的安装包进行安装 (Mac Only)。
- 安装过程中可能需要授予应用 Google Sign-In 权限。
- 应用启动后会自动下载和解析联系人数据,首次启动可能需要一些时间。
服务器配置
要将 Orbit MCP 服务器配置到 MCP 客户端(例如 Claude Desktop),需要在客户端的配置文件中添加 Orbit MCP 服务器的配置信息。以下是一个配置示例,通常 MCP 客户端需要一个 JSON 格式的配置文件(例如 'claude_desktop_config.json'),在 'mcpServers' 字段下添加 'orbit-mcp' 的配置:
{ "mcpServers": { "orbit-mcp": { "command": "npx", "args": [ "@orbitapp/orbit-mcp@latest" ] } } }
- '"orbit-mcp"': 服务器名称,用于在客户端中标识 Orbit MCP 服务器。用户可以自定义此名称。
- '"command": "npx"': 启动服务器的命令,这里使用 'npx' (Node Package eXecutor) 来运行 npm 包。
- '"args": ["@orbitapp/orbit-mcp@latest"]': 传递给 'npx' 的参数,指定要运行的 npm 包为 '@orbitapp/orbit-mcp','@latest' 表示使用最新版本。
注意: 用户无需手动执行 'command' 和 'args' 中的命令。MCP 客户端在需要时会自动根据配置启动 MCP 服务器。用户只需将以上配置信息添加到 MCP 客户端的配置文件中。
基本使用方法
- 启动 Orbit 应用,并确保它在后台运行。
- 配置 MCP 客户端(例如 Claude Desktop)连接到 Orbit MCP 服务器,配置信息如 服务器配置 所示。
- 在 MCP 客户端中,应该可以看到 Orbit 提供的工具入口(例如,Claude Desktop 中会显示一个锤子图标,数字可能表示可用工具的数量)。
- 在与 LLM 的对话中,可以使用自然语言指令来查询和操作联系人信息。例如:
- 提问 "What do you know about [联系人姓名]?"
- 指示 "Update [联系人姓名]'s company to [新公司名称]"
- 指示 "Send an email to [联系人姓名] to check in" (如果 Orbit 提供了发送邮件的工具)
请参考 MCP 客户端的具体文档,了解如何使用 MCP 服务器提供的工具和功能。
信息
分类
生产力应用