使用说明

项目简介

Orbit MCP Server 是 Orbit 应用的 MCP 服务器组件，旨在为大型语言模型 (LLM) 客户端提供个人联系人信息的上下文访问和操作能力。通过 Orbit MCP Server，LLM 可以理解您的联系人网络，回答关于联系人的问题，并执行与联系人相关的操作，从而增强 LLM 的对话智能化和实用性。

主要功能点

联系人信息查询: 允许 LLM 客户端查询关于您的联系人的信息，例如“[姓名]的基本信息是什么？”。
联系关系理解: 使 LLM 能够理解您与联系人之间的关系，例如“我与 [姓名] 是什么时候认识的？” 或 “我与 [姓名1] 和 [姓名2] 有哪些共同兴趣？”。
联系人数据编辑: 支持 LLM 客户端请求更新联系人信息，例如修改联系频率、记录会面时间、更新兴趣爱好、工作信息等。
事件提醒: 主动向用户推送即将到来的联系人生日、纪念日以及计划的联系跟进提醒。
集成 Claude 等 LLM 客户端: 通过 MCP 协议与 Claude Desktop 等客户端集成，扩展 LLM 的上下文理解和操作能力。

安装步骤

下载并安装 Orbit 桌面应用 (Mac Only)：访问仓库链接 https://github.com/ajram23/Orbit ，根据 README 中的 “📦 | Install instructions (Mac Only)” 指示，下载并安装 Orbit 桌面应用程序。
授权 Google 账号权限: 首次启动 Orbit 应用时，根据提示授权 Google 账号访问权限，以便应用能够下载和解析您的联系人信息。
等待联系人数据同步: 应用需要一些时间下载和分析您的联系人数据，请耐心等待数据同步完成。

服务器配置

要将 Orbit MCP Server 与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在 MCP 客户端中配置 Orbit MCP Server 的启动信息。以 Claude Desktop 为例，配置步骤如下：

打开 Claude Desktop 设置: 启动 Claude Desktop 应用程序，进入设置界面。
进入开发者选项: 在设置中找到 “Developer” 或 “开发者” 选项。
编辑配置: 点击 “Edit Config” 或 “编辑配置” 按钮，打开 'claude_desktop_config.json' 配置文件。

添加 Orbit MCP Server 配置: 在 'claude_desktop_config.json' 文件中的 'mcpServers' 字段下，添加以下 JSON 配置信息：

{
  "mcpServers": {
    "orbit-mcp": {
      "serverName": "orbit-mcp", // 服务器名称，用于在客户端中标识
      "command": "npx",        // 启动服务器的命令，这里使用 npx 执行 npm 包
      "args": [
        "@orbitapp/orbit-mcp@latest" // 命令参数，指定要执行的 npm 包名称和版本
      ]
    }
  }
}

重启 Claude Desktop: 关闭并重新启动 Claude Desktop 应用程序，使配置生效。
验证 MCP 工具: 重启后，您应该能在 Claude Desktop 界面中看到一个锤子图标，数字表示可用的 MCP 工具数量（如果只配置了 Orbit MCP Server，且工具正常加载，则数字可能为 3）。点击锤子图标可以查看可用的 MCP 工具列表。

基本使用方法

启动 LLM 客户端: 完成配置后，启动您配置的 MCP 客户端（例如 Claude Desktop）。
开始对话: 在 LLM 客户端中发起新的对话。
使用 MCP 工具: 在对话过程中，您可以利用 Orbit MCP Server 提供的工具，例如：
- 询问关于联系人的问题，如 “What do you know about [联系人姓名]?”
- 请求更新联系人信息，如 “I met with [联系人姓名] this past Sunday, can you please update it?”
- 基于联系人信息进行任务，如 “I am in the mood for Sichuan in NYC. Who should I ask?”
具体可使用的工具和指令请参考 Orbit 应用或 MCP 客户端的文档说明。

关键词