CompanyData

CompanyData MCP サーバー

CompanyData HTTP APIをツールとして公開するModel Context Protocolサーバーです。提供するツールは、企業検索、企業データのエクスポート（エンリッチ）、所在地検索（都市）です。

製品概要とセットアップガイド：companydata.com/product/mcp-server/。

OpenAPIコントラクト：https://companydata.com/openapi.json。

ホステッド（インストール不要）

MCP クライアントをhttps://companydata.com/mcp/に接続し、API キーをx-api-keyヘッダーで送信してください（キーを取得）。

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を実行してください（シェルで環境変数を読み込む場合：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"
      }
    }
  }
}

CLI

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 Registry：com.companydata/mcp（server.jsonを参照）。

ライセンス

ISC