mcpField
S
score-mcp-quickstart

score-mcp-quickstart

ローカル
github.com/Alessandro114ビジネス・マーケティング05 日前に更新
リポジトリ

score-mcp-quickstart について

score-mcp-quickstartは、S.C.A.L.A. Score APIで企業データを検索するためのガイドとMCPサーバー構成例です。企業検索、企業レコード取得、API利用状況確認のツールを扱い、売上データの推定区分やデータの帰属表示についても説明します。

主な機能

  1. 01名称または税番号で企業検索
  2. 02企業レコードの取得
  3. 03API利用状況の確認
  4. 04申告売上と推定売上の区別

活用シーン

  1. 01名称または税番号で企業を検索
  2. 02企業の詳細レコードを取得
  3. 03APIの残り利用状況を確認
  4. 04データ再配布時に帰属表示を保持

MCP 対応

ガイドでは、`search_companies`、`get_company`、`get_usage`ツールを備えたstdio MCPサーバーを説明します。Claude DesktopとClaude Codeの設定方法も記載されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "alessandro114-score-mcp-quickstart": {
      "command": "npx",
      "args": [
        "-y",
        "score-mcp-quickstart"
      ],
      "env": {
        "SCORE_API_KEY": "<SCORE_API_KEY>"
      }
    }
  }
}
起動コマンドnpx -y score-mcp-quickstart
設定が必要な環境変数
SCORE_API_KEYシークレットFree key from https://score.get-scala.com/api/free-key

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmscore-mcp-quickstart0.1.1

ツール

3

掲載時のツール一覧 · 3 日前に更新

パラメーター型必須説明
qstringいいえ
limitintegerいいえ
tax_idstringいいえ
countrystringいいえ

詳細

クイックスタート：5 分で AI エージェントに企業データを

  1. 無料キーを取得します（月 50 回、カード不要）：https://score.get-scala.com/api/free-key
  2. 試してみます：
export SCORE_API_KEY=sk_score_...
curl -H "X-API-Key: $SCORE_API_KEY" "https://score.get-scala.com/api/v1/search?tax_id=IT00159560366&limit=1"
curl -H "X-API-Key: $SCORE_API_KEY" "https://score.get-scala.com/api/v1/usage"
  1. 取得できる情報を確認します：/api/v1/company/{id} を呼び出し、revenue_type（reported = 提出済みの決算書、estimated = モデルによる推定）と revenue_confidence を確認します。検索結果だけでは、これらの情報は取得できません。
  2. エージェントに渡します（MCP、stdio）：
npm i @modelcontextprotocol/sdk zod
SCORE_API_KEY=sk_score_... node mcp-score.mjs

Claude Desktop / Claude Code の設定：{"mcpServers":{"score":{"command":"node","args":["/path/mcp-score.mjs"],"env":{"SCORE_API_KEY":"sk_score_..."}}}} ツール：search_companies（社名または納税者番号、国は任意）、get_company、get_usage。 呼び出しごとにクレジットを 1 消費します。無料キーは月 50 回です。有料パックは一回限りのクレジットです（500 = €15、2,000 = €39）。サブスクリプションはありません。データを再配布する場合は、data_licences の帰属表示を保持してください。

データライセンス：レスポンスには data_licences ブロックが含まれます。データを再配布する場合は、帰属表示を保持してください。財務情報が返されるのは FR、NO、LT、EE、LV、CO のみです。

API ドキュメント、プラン、キー：https://score.get-scala.com/api/?utm_source=github&utm_medium=readme&utm_campaign=mcp

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。