CompanyData

CompanyData MCP 服务

Model Context Protocol 服务，可将 CompanyData HTTP API 作为工具提供：公司搜索、公司导出（数据补充）和位置查询（城市）。

产品概览和设置指南：companydata.com/product/mcp-server/。

OpenAPI 契约：https://companydata.com/openapi.json。

托管版（无需安装）

将 MCP 客户端连接到 https://companydata.com/mcp/，并在 x-api-key 请求头中发送 API 密钥（获取密钥）。

Claude Code：

claude mcp add --transport http companydata https://companydata.com/mcp/ --header "x-api-key: your-api-key-here"

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "companydata": {
      "url": "https://companydata.com/mcp/",
      "headers": { "x-api-key": "your-api-key-here" }
    }
  }
}

本地运行（npx）

需要 Node.js 18+。

{
  "mcpServers": {
    "companydata": {
      "command": "npx",
      "args": ["-y", "@companydata/mcp-server"],
      "env": { "COMPANYDATA_API_KEY": "your-api-key-here" }
    }
  }
}

从源代码构建

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

环境变量

变量	必需	描述
COMPANYDATA_API_KEY	是	每次请求都会作为 x-api-key 发送
COMPANYDATA_API_BASE_URL	否	API 源站，默认为 https://app.companydata.com（末尾不带斜杠）

本地测试时，将 .env.example 复制为 .env，然后运行 npm run dev（在 Shell 中加载环境变量：set -a && source .env && set +a && npm run dev）。

工具

工具	API
company_search	GET /api/company/search
company_enrich	使用 ID 和 export=true 调用 GET /api/company/export
field_lookup	GET /api/cities

Cursor 和 Claude Desktop

1. 构建项目（npm run build）。
2. 在 MCP 宿主（例如 Cursor Settings → MCP 或 Claude Desktop 配置）中添加服务（调整路径）：

{
  "mcpServers": {
    "companydata": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/companydata-mcp-server/dist/index.js"],
      "env": {
        "COMPANYDATA_API_KEY": "your-api-key-here",
        "COMPANYDATA_API_BASE_URL": "https://app.companydata.com"
      }
    }
  }
}

3. 如有需要，重新加载 MCP / 重启 Cursor。

冒烟测试清单

• 服务启动时没有错误（设置好环境变量后运行 npm run build && node dist/index.js）。
• MCP 宿主列出以下工具：company_search、company_enrich、field_lookup。
• company_search 对简单查询（例如 search=BoldData）返回 200 响应数据。
• field_lookup 返回城市建议（例如 search=amst）。

无需单独构建步骤的开发方式：

{
  "mcpServers": {
    "companydata": {
      "command": "npx",
      "args": ["tsx", "/ABSOLUTE/PATH/TO/companydata-mcp-server/src/index.ts"],
      "env": {
        "COMPANYDATA_API_KEY": "your-api-key-here",
        "COMPANYDATA_API_BASE_URL": "https://app.companydata.com"
      }
    }
  }
}

命令行界面

运行 npm run build 后，在链接（npm link）时，或当 node_modules/.bin 位于 PATH 中时，包会提供 companydata-mcp。

分发

• 托管版：https://companydata.com/mcp/（Streamable HTTP，无状态）。网站通过 src/tools.ts 的副本提供相同的工具。
• npm：@companydata/mcp-server。
• 官方 MCP 注册表：com.companydata/mcp（参见 server.json）。

许可证

ISC