alternativespe-mcp

alternativespe-mcp

Alternatives Partner API v3（altdmp.io）向けの MCP サーバーです。東南アジアのプライベートマーケットデータ（資金調達企業、投資家、ファンド、人材、サービスプロバイダー）に読み取り専用でプログラムからアクセスできます。

機能

• API キーからベアラートークンへの交換を自動処理し、トークンをキャッシュして更新します。
• 各リストエンドポイントで、完全な POST フィルターツリー（all／any／not と演算子）に加え、search、ordering、limit、offset を利用できます。
• すべての主要エンティティに UUID を指定して詳細を取得するツールを提供します。

ツール

ツール	エンドポイント	説明
search_capital_receivers	POST /capital-receivers/	資金調達企業／スタートアップ
get_capital_receiver	GET /capital-receivers/{uuid}/	企業の詳細：財務情報、資本政策表、投資家、取引、ニュース
search_capital_allocators	POST /capital-allocators/	投資家（VC／PE、事業会社、ファミリーオフィス）
get_capital_allocator	GET /capital-allocators/{uuid}/	投資家の詳細：投資、AUM、コミットメント、ファンド、ニュース
search_funds	POST /funds/	ファンド（Atlas ティア）
get_fund	GET /funds/{uuid}/	ファンドの詳細：パフォーマンス、AUM、コミットメント、投資
search_people	POST /people/	創業者、取締役、経営幹部
get_person	GET /people/{uuid}/	人材の詳細：役職、投資、ニュース
search_service_providers	POST /service-providers/	監査、法律・専門サービス
search_investors	POST /investors/	エンティティ横断での投資家検索
get_reference_data	GET /reference-data/	列挙型、国、業界、テーマ

セットアップ

npm install
npm run build

API キーを設定します（[email protected] から認証情報を取得してください）。

export ALTDMP_API_KEY=your_api_key_here

Claude Desktop／Claude Code での使用

MCP 設定に追加します（例：claude_desktop_config.json）。

{
  "mcpServers": {
    "alternativespe": {
      "command": "node",
      "args": ["/absolute/path/to/alternativespe-mcp/dist/index.js"],
      "env": {
        "ALTDMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

または、ビルドせずにローカル開発する場合：

{
  "mcpServers": {
    "alternativespe": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/alternativespe-mcp/src/index.ts"],
      "env": { "ALTDMP_API_KEY": "your_api_key_here" }
    }
  }
}

フィルタリング

filters は API の filters 本文としてそのまま転送されます。条件と論理グループを組み合わせます。

{
  "filters": {
    "all": [
      { "op": "eq", "field": "domicile_country_iso_alpha3", "value": "SGP" },
      { "op": "gte", "field": "latest_valuation_usd", "value": 50000000 },
      { "any": [
        { "op": "eq", "field": "is_raising_now", "value": true },
        { "op": "in", "field": "themes_keys", "value": ["themes_payments"] }
      ]}
    ]
  },
  "limit": 50,
  "ordering": "-latest_valuation_usd"
}

演算子： eq、in（配列）、gt、gte、lt、lte、range（2 要素の配列）、contains、isnull。 論理グループ： all（AND）、any（OR）、not（否定）。

有効なフィールドの列挙値を調べるには、get_reference_data を使用してください。

注意事項

• レート制限：60 秒間のローリングウィンドウで 320 リクエスト（API によって適用されます）。
• サブスクリプションティア：Atlas（すべてのエンドポイント）および Allocate（ファンドとアロケーターのコミットメントを除く）。
• トークンの有効期間は 24 時間です。このサーバーはトークンを自動更新します。

環境変数

変数	必須	デフォルト	説明
ALTDMP_API_KEY	はい	—	Alternatives Partner API キー
ALTDMP_BASE_URL	いいえ	https://api.altdmp.io/v3	API ベース URL の上書き

公開

npm と MCP Registry のどちらも OIDC で公開されます。このリポジトリに長期有効なトークンは保存されません。

npm（Trusted Publishing／OIDC）

自動公開には npm Trusted Publishing を使用します。GitHub Actions は有効期間の短い OIDC を介して npm に認証し、provenance は自動生成されるため、NPM_TOKEN は不要です。

npmjs.com での初回セットアップ（最初のバージョンが存在してから実施します。下記の初回公開を参照）：パッケージの Settings → Trusted Publisher → GitHub Actions を開き、次のように設定します。

項目	値
Organization / user	luarss
Repository	alternativespe-mcp
Workflow filename	publish-mcp-registry.yml
Environment	release

初回公開： Trusted Publisher はパッケージがすでに存在する場合にのみ設定できるため、最初のバージョンは手動で公開する必要があります。ローカルで npm publish --access public を実行し、その後、以降のすべてのリリースに Trusted Publisher を設定してください。

MCP Registry

server.json は、GitHub OIDC（mcp-publisher login github-oidc）を使用する mcp-publisher CLI 経由で、公式 MCP Registry に公開されます。トークンも不要です。

自動リリース

v* タグ（例：git tag v0.1.0 && git push origin v0.1.0）をプッシュすると、.github/workflows/publish-mcp-registry.yml が実行されます。このジョブは、保護された release GitHub 環境（必須のレビュアーと v* タグのみを許可）で実行されるため、公開には手動承認が必要です。承認後、npm に公開（OIDC）し、server.json のバージョンをタグに合わせてから、レジストリに公開（OIDC）します。

ライセンス

WTFPL