Rogerroger MCP Server

RogerRoger MCP 服务器

一个模型上下文协议（MCP）服务器用于 RogerRoger API这台服务器允许像Claude这样的AI助手通过标准化的MCP工具与您的RogerRoger数据进行交互。

特点/功能

• 🧑‍🤝‍🧑（两人握手） 人员管理创建、读取、更新和删除联系人
• 🏢 翻译为中文是：办公楼/公司/企业（的标志） 组织管理创建、读取、更新和删除组织
• 📋（清单/列表） 列表管理创建、读取、更新和删除列表/分段，以便组织联系人
• 🏷️（标签） 标签管理创建、读取、更新和删除标签，标签颜色可自定义
• ✅ 任务管理创建和检索任务
• 🔐 安全认证使用API密钥进行安全访问
• 📊 表格/数据图表 分页支持高效处理大型数据集

设置说明

基本设置

1. 安装该软件包：

npm install -g @rogerrogerio/mcp-server

1. 获取您的RogerRoger API密钥：

- 登录您的RogerRoger账户 - 导航至 管理面板 > API - 生成或复制您的API密钥

1. 运行服务器：

npx @rogerrogerio/mcp-server

Claude桌面设置

在Claude Desktop中设置此MCP服务器：

1. 全局安装该包 如果你还没做的话：

npm install -g @rogerrogerio/mcp-server

1. 创建或编辑 Claude桌面配置文件：

- macOS（中文常译为“苹果电脑操作系统”或简称“苹果系统”）： ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json

添加MCP服务器配置：

{
  "mcpServers": {
    "rogerroger": {
      "command": "npx",
      "args": ["-y", "@rogerrogerio/mcp-server"],
      "env": {
        "ROGERROGER_API_KEY": "your_api_key_here"
      }
    }
  }
}

1. 重启Claude桌面版 彻底（退出并重新打开）。

1. 验证连接 - 您应该在Claude Desktop中看到RogerRoger MCP服务器指示器。

从源代码安装

如果您更倾向于从源代码安装：

git clone https://github.com/rogerrogerhq/rogerroger-mcp-server.git
cd rogerroger-mcp-server
npm install
npm run build

然后更新您的Claude桌面配置以使用本地安装：

{
  "mcpServers": {
    "rogerroger": {
      "command": "node",
      "args": ["/absolute/path/to/rogerroger-mcp-server/dist/index.js"],
      "env": {
        "ROGERROGER_API_KEY": "your_api_key_here"
      }
    }
  }
}

配置选项

以下环境变量可以进行配置：

用法

使用 Claude Desktop

配置完成后，只需与Claude聊天并参考您的RogerRoger数据：

示例：

• “给我看看我的联系人”
• “创建一个名为Sarah Smith的新用户，邮箱为sarah@example.com”
• “列出我们CRM中的所有组织”
• “创建一个名为Acme Corp的新组织”
• “显示我的所有列表”
• “创建一个名为‘热门线索’的新列表，并添加一个星形图标”
• “显示所有标签”
• “创建一个名为‘VIP’的新标签，背景设为金色”
• “我被分配了哪些任务？”
• “更新联系人ID abc123 的电话号码为 +1234567890”

独立运行（高级）

用于开发或测试：

npm start

服务器将在标准输入输出（stdio）上运行，并等待MCP请求。

可用工具

人员管理

• rogerroger:get_people获取所有联系人，可选择分页
• rogerroger:get_person通过ID获取特定人员
• rogerroger:create_person创建一个新的联系人
• rogerroger:update_person更新现有联系人
• rogerroger:delete_person删除一个联系人

组织管理

• rogerroger:get_organizations检索所有组织，并支持可选分页
• rogerroger:get_organization通过ID获取特定组织
• rogerroger:create_organization创建一个新组织
• rogerroger:update_organization更新现有组织
• rogerroger:delete_organization删除一个组织

列表管理

• rogerroger:get_lists获取所有列表/段，支持可选分页
• rogerroger:get_list通过ID获取特定列表
• rogerroger:create_list创建一个新列表/分段
• rogerroger:update_list更新现有列表
• rogerroger:delete_list删除一个列表

标签管理

• rogerroger:get_tags获取所有标签，并支持可选的分页功能
• rogerroger:get_tag通过ID获取特定标签
• rogerroger:create_tag创建一个具有自定义颜色的新标签
• rogerroger:update_tag更新现有标签
• rogerroger:delete_tag删除一个标签

任务管理

• rogerroger:get_tasks检索任务，可选择性过滤
• rogerroger:create_task创建一个新任务

API示例

获取所有人信息

// Returns paginated list of all contacts
await callTool("rogerroger:get_people", {
  limit: 50,
  offset: 0,
});

创建一个新的联系人

await callTool("rogerroger:create_person", {
  name: "John Doe",
  email: "john@example.com",
  phone: "+1234567890",
  company: "Acme Corp",
  notes: "Met at conference",
});

创建一个组织

await callTool("rogerroger:create_organization", {
  name: "Acme Corporation",
  website: "https://acme.com",
  industry: "Technology",
  employees: 500,
  notes: "Potential enterprise client",
});

创建一个列表

await callTool("rogerroger:create_list", {
  title: "Hot Leads",
  icon: "star",
  sequence: 1,
});

获取所有列表

// Returns paginated list of all lists/segments
await callTool("rogerroger:get_lists", {
  page: 1,
  itemsPerPage: 15,
});

创建一个标签

await callTool("rogerroger:create_tag", {
  title: "VIP Client",
  backgroundColor: "#FFD700",
  textColor: "#000000",
  description: "High-value clients requiring special attention",
});

获取所有标签

// Returns paginated list of all tags
await callTool("rogerroger:get_tags", {
  page: 1,
  itemsPerPage: 30,
});

创建任务

await callTool("rogerroger:create_task", {
  title: "Follow up with John",
  description: "Schedule a demo call",
  due_date: "2024-12-31",
  assignee_id: "person_123",
  priority: "high",
});

发展

设置

git clone https://github.com/rogerrogerhq/rogerroger-mcp-server.git
cd rogerroger-mcp-server
npm install

构建

npm run build

手表模式

npm run dev

Linting（代码检查/静态分析）

npm run lint

测试

npm test

项目结构

src/
├── index.ts          # Main MCP server implementation
├── types/           # TypeScript type definitions
└── utils/           # Utility functions

dist/                # Compiled JavaScript output

贡献；做出贡献

1. 为仓库创建分支（或：克隆仓库）
2. 创建一个特性分支（git checkout -b feature/amazing-feature)
3. 提交您的更改（git commit -m 'Add some amazing feature')
4. 推送到分支（git push origin feature/amazing-feature）
5. 提交一个拉取请求

API 文档

这个MCP服务器是基于……构建的 RogerRoger API文档随着RogerRoger扩展其API，我们将增加更多工具和功能。

当前支持的端点：

• GET /people - 列出所有人
• GET /people/{id} - 通过ID获取人员
• POST /people - 创建新用户
• PUT /people/{id} - 更新人员信息
• DELETE /people/{id} - 删除人员
• GET /organizations - 列出所有组织
• GET /organizations/{id} - 通过ID获取组织信息
• POST /organizations - 创建新组织
• PUT /organizations/{id} - 更新组织
• DELETE /organizations/{id} - 删除组织
• GET /segments - 列出所有列表/细分市场
• GET /segments/{id} - 通过ID获取列表
• POST /segments - 创建新列表
• PATCH /segments/{id} - 更新列表
• DELETE /segments/{id} - 删除列表
• GET /tags - 列出所有标签
• GET /tags/{id} - 通过ID获取标签
• POST /tags - 创建新标签
• PATCH /tags/{id} - 更新标签
• DELETE /tags/{id} - 删除标签
• GET /tasks - 列出任务
• POST /tasks - 创建任务

错误处理

该服务器包括对以下方面的全面错误处理：

• 缺少API密钥
• 网络故障
• 无效的API响应
• 格式错误的请求

所有错误都以结构化的MCP响应形式返回，并附带描述性消息。

安全注意事项

此服务器可访问您的敏感数据，因此应部署适当的安全措施。请考虑：

• 确保您的API密钥安全，切勿将其提交到版本控制系统中
• 使用环境变量进行配置
• 在适当情况下限制网络访问
• 定期轮换您的API密钥

许可证

MIT 许可证 - 详见 许可证 文件中详述。

支持

• 🐛 蚜虫（或瓢虫，根据具体上下文可有所不同） 报告问题
• 📖（这个符号本身没有直接的中文翻译，它通常代表“书”或“书籍”的意思，在某些上下文中可以理解为“书本”或“阅读材料”。） RogerRoger API 文档
• 💬（表示对话或评论的符号，无具体含义，可不译或根据上下文译为“对话”、“评论”等） 模型上下文协议

更新日志

v1.0.3

• 搜索功能的错误修复

版本1.0.2

• 添加了组织管理端点
• 添加了列表/段管理端点
• 添加了标签管理端点
• 对组织、列表和标签进行全面的增删改查（CRUD）操作
• 支持自定义标签颜色（背景色、文字色）
• 支持带分页和每页项目数参数的列表分页功能
• 更新了包含示例的文档

版本1.0.1

• 错误修复和改进

v1.0.0（版本1.0.0）

• 首次发布
• 人员与任务管理支持
• 基本的CRUD操作
• 全面的错误处理