RogerRoger MCP 服务器
一个模型上下文协议(MCP)服务器用于 RogerRoger API这台服务器允许像Claude这样的AI助手通过标准化的MCP工具与您的RogerRoger数据进行交互。
特点/功能
- 🧑🤝🧑(两人握手) 人员管理创建、读取、更新和删除联系人
- 📋(清单/列表) 列表管理创建、读取、更新和删除列表/分段,以便组织联系人
- 🏷️(标签) 标签管理创建、读取、更新和删除标签,标签颜色可自定义
- ✅ 任务管理创建和检索任务
- 🔐 安全认证使用API密钥进行安全访问
- 📊 表格/数据图表 分页支持高效处理大型数据集
设置说明
基本设置
- 安装该软件包:```bash
npm install -g @rogerrogerio/mcp-server
2. **获取您的RogerRoger API密钥:**
- 登录您的RogerRoger账户
- 导航至 管理面板 > API
- 生成或复制您的API密钥
1. **运行服务器:**```bash
npx @rogerrogerio/mcp-server
Claude桌面设置
在Claude Desktop中设置此MCP服务器:
- 全局安装该包 如果你还没做的话:```bash
npm install -g @rogerrogerio/mcp-server
2. **创建或编辑** Claude桌面配置文件:
- **macOS(中文常译为“苹果电脑操作系统”或简称“苹果系统”)**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
添加MCP服务器配置:```json
{
"mcpServers": {
"rogerroger": {
"command": "npx",
"args": ["-y", "@rogerrogerio/mcp-server"],
"env": {
"ROGERROGER_API_KEY": "your_api_key_here"
}
}
}
}
-
重启Claude桌面版 彻底(退出并重新打开)。
-
验证连接 - 您应该在Claude Desktop中看到RogerRoger MCP服务器指示器。
从源代码安装
如果您更倾向于从源代码安装:```bash
git clone https://github.com/rogerrogerhq/rogerroger-mcp-server.git
cd rogerroger-mcp-server
npm install
npm run build
然后更新您的Claude桌面配置以使用本地安装:```json
{
"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”
独立运行(高级)
用于开发或测试:```bash
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示例
### 获取所有人信息```typescript
// Returns paginated list of all contacts
await callTool("rogerroger:get_people", {
limit: 50,
offset: 0,
});
创建一个新的联系人```typescript
await callTool("rogerroger:create_person", {
name: "John Doe",
email: "john@example.com",
phone: "+1234567890",
company: "Acme Corp",
notes: "Met at conference",
});
### 创建一个组织```typescript
await callTool("rogerroger:create_organization", {
name: "Acme Corporation",
website: "https://acme.com",
industry: "Technology",
employees: 500,
notes: "Potential enterprise client",
});
创建一个列表```typescript
await callTool("rogerroger:create_list", {
title: "Hot Leads",
icon: "star",
sequence: 1,
});
### 获取所有列表```typescript
// Returns paginated list of all lists/segments
await callTool("rogerroger:get_lists", {
page: 1,
itemsPerPage: 15,
});
创建一个标签```typescript
await callTool("rogerroger:create_tag", {
title: "VIP Client",
backgroundColor: "#FFD700",
textColor: "#000000",
description: "High-value clients requiring special attention",
});
### 获取所有标签```typescript
// Returns paginated list of all tags
await callTool("rogerroger:get_tags", {
page: 1,
itemsPerPage: 30,
});
创建任务```typescript
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",
});
## 发展
### 设置```bash
git clone https://github.com/rogerrogerhq/rogerroger-mcp-server.git
cd rogerroger-mcp-server
npm install
构建```bash
npm run build
### 手表模式```bash
npm run dev
Linting(代码检查/静态分析)```bash
npm run lint
### 测试```bash
npm test
项目结构```
src/
├── index.ts # Main MCP server implementation
├── types/ # TypeScript type definitions
└── utils/ # Utility functions
dist/ # Compiled JavaScript output
```
贡献;做出贡献
- 为仓库创建分支(或:克隆仓库)
- 创建一个特性分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推送到分支(
git push origin feature/amazing-feature) - 提交一个拉取请求
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 许可证 - 详见 许可证 文件中详述。
支持
- 🐛 蚜虫(或瓢虫,根据具体上下文可有所不同) 报告问题
- 💬(表示对话或评论的符号,无具体含义,可不译或根据上下文译为“对话”、“评论”等) 模型上下文协议
更新日志
v1.0.3
- 搜索功能的错误修复
版本1.0.2
- 添加了组织管理端点
- 添加了列表/段管理端点
- 添加了标签管理端点
- 对组织、列表和标签进行全面的增删改查(CRUD)操作
- 支持自定义标签颜色(背景色、文字色)
- 支持带分页和每页项目数参数的列表分页功能
- 更新了包含示例的文档
版本1.0.1
- 错误修复和改进
v1.0.0(版本1.0.0)
- 首次发布
- 人员与任务管理支持
- 基本的CRUD操作
- 全面的错误处理
