Sumble MCP服务器
一个MCP（模型上下文协议）服务器，为Claude提供对Sumble API的访问，用于组织丰富、人员发现和工作列表。
特性
此MCP服务器公开了四个工具：
| 工具 | 描述 | 信贷成本 |
|---|---|---|
find_organizations | 按技术栈、类别或查询查找公司 | 5学分/filter/org |
enrich_organization | 获取特定公司的详细技术数据 | 5学分/技术 |
find_jobs | 按技术、地点或公司搜索职位列表 | 3学分/职位 |
find_people | 按角色、级别或地点查找公司人员 | 1个学分/人 |
先决条件
- Node.js 18或更高版本
- 一个Sumble API密钥（在https://sumble.com/account/api-keys)
安装
# Clone or download this directory
cd sumble-mcp-server
# Install dependencies
npm install
# Build the TypeScript
npm run build配置
将Sumble API密钥设置为环境变量：
export SUMBLE_API_KEY="your-api-key-here"使用选项
方案1：地方发展（stdio）
对于本地测试或与Claude Desktop一起使用：
npm start
# or for development with hot reload
npm run dev选项2:HTTP/SSE服务器（用于Claude.ai自定义连接器）
运行HTTP服务器进行远程部署：
# Build first
npm run build
# Start the HTTP server
node dist/server-http.js
# Server starts on port 3000 by default
# Change with: PORT=8080 node dist/server-http.js部署Claude.ai自定义连接器
要将其与Claude.ai的自定义连接器功能一起使用，您需要将HTTP/SSE服务器部署到可公开访问的URL。
部署到铁路（推荐）
- 创建一个 铁路 账户
- 从GitHub创建新项目
- 添加环境变量：
SUMBLE_API_KEY - 铁路将自动检测和部署
部署以渲染
- 创建一个 渲染 账户
- 创建新的Web服务
- 连接您的GitHub仓库
- 设置构建命令：
npm install && npm run build - 设置启动命令：
node dist/server-http.js - 添加环境变量：
SUMBLE_API_KEY
部署到Fly.io
# Install flyctl
curl -L https://fly.io/install.sh | sh
# Login
fly auth login
# Launch (first time)
fly launch
# Set secret
fly secrets set SUMBLE_API_KEY="your-api-key"
# Deploy
fly deploy部署到Cloudflare Workers
看 cloudflare/ Workers兼容版本的目录。
添加到Claude.ai
部署后：
- 转到Claude.ai设置→ 连接器
- 点击“添加自定义连接器”
- 填写：
- 名字: Sumble - 远程MCP服务器URL: https://your-deployment-url.com/sse - 将OAuth字段保留为空（API密钥在服务器中）
- 点击“添加”
工具示例
使用Python查找组织
{
"technologies": ["python"],
"limit": 10
}丰富公司的技术栈
{
"domain": "stripe.com",
"technology_categories": ["Cloud Infrastructure"]
}寻找工程工作
{
"technologies": ["react", "typescript"],
"countries": ["US"],
"limit": 20
}寻找公司高管
{
"domain": "anthropic.com",
"job_levels": ["Executive", "C-Level"],
"limit": 10
}与Claude Desktop一起使用
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"sumble": {
"command": "node",
"args": ["/path/to/sumble-mcp-server/dist/index.js"],
"env": {
"SUMBLE_API_KEY": "your-api-key-here"
}
}
}
}API费率限制
Sumble API每秒允许10个请求。MCP服务器遵守这些限制。
故障排除
“需要SUMBLE_API_KEY环境变量”
确保您已设置环境变量：
export SUMBLE_API_KEY="your-key"连接被拒绝
确保服务器正在运行并且端口可访问。对于远程部署，请检查防火墙/安全组设置。
401未经Sumble API授权
您的API密钥可能无效或已过期。生成一个新的https://sumble.com/account/api-keys
许可证
麻省理工学院