AI导哈

组织数据查询服务

Sumble MCP服务器为Claude提供访问Sumble API的功能，用于组织数据丰富、人员发现和职位列表查询。

  • by davidee-alt
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 davidee-alt/sumble-mcp-server

使用说明

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。

部署到铁路（推荐）

  1. 创建一个 铁路 账户
  2. 从GitHub创建新项目
  3. 添加环境变量： SUMBLE_API_KEY
  4. 铁路将自动检测和部署

部署以渲染

  1. 创建一个 渲染 账户
  2. 创建新的Web服务
  3. 连接您的GitHub仓库
  4. 设置构建命令： npm install && npm run build
  5. 设置启动命令： node dist/server-http.js
  6. 添加环境变量： 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

部署后：

  1. 转到Claude.ai设置→ 连接器
  2. 点击“添加自定义连接器”
  3. 填写：
    • 名字: Sumble
    • 远程MCP服务器URL: https://your-deployment-url.com/sse
    • 将OAuth字段保留为空（API密钥在服务器中）
  4. 点击“添加”

工具示例

使用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

许可证

麻省理工学院

相关 MCP