Sorsa Api Mcp

Sorsa MCP

Sorsa.io API v3 用の MCP サーバーです。
X/Twitter のデータ（プロフィール、ツイート、検索、フォロー／リツイートの確認、Sorsa スコア、リスト、コミュニティ）にアクセスできます。

このサーバーは、API エンドポイントごとに 40 個のツールを公開します。

インストール

npm install
npm run build

または、公開後は npx を使ってインストールせずに実行できます（下記を参照）。

設定

Sorsa API キーが必要です。キーは環境変数 SORSA_API_KEY から読み込まれ、すべてのリクエストで ApiKey ヘッダーとともに送信されます。

変数	必須	デフォルト
SORSA_API_KEY	はい	—
SORSA_BASE_URL	いいえ	https://api.sorsa.io/v3

クライアントの接続

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）に追加します。

公開済みの npm パッケージを使う場合（インストール不要で、npx が取得します）：

{
  "mcpServers": {
    "sorsa": {
      "command": "npx",
      "args": ["-y", "sorsa-mcp"],
      "env": {
        "SORSA_API_KEY": "YOUR_KEY"
      }
    }
  }
}

または、ローカルでビルドしたチェックアウトから実行する場合：

{
  "mcpServers": {
    "sorsa": {
      "command": "node",
      "args": ["D:\\Code\\Cursor Projects\\Sorsa_MCP\\dist\\index.js"],
      "env": {
        "SORSA_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json を編集し、上記と同じ mcpServers ブロックを追加してから、アプリを再起動します。

ローカルでの確認

# build
npm run build

# run (communicates over stdio — easiest to test through a client)
SORSA_API_KEY=YOUR_KEY npm start

キーが機能することを最も手早く確認するには、get_key_usage_info ツールを使います。このツールは、残りのリクエスト数とキーの有効期限を返します。

利用可能なツール

プロフィール： get_user_info、get_user_info_batch、get_followers、get_following、 get_verified_followers、get_account_about

ツイート： get_tweet_info、get_tweet_info_bulk、get_user_tweets、get_tweet_comments、 get_tweet_quotes、get_retweeters、get_article、get_trends

検索： search_tweets、search_users、search_mentions、get_space_info

コミュニティ： get_community_members、get_community_tweets、search_community_tweets

確認： check_follow、check_comment、check_quoted、check_retweet、 check_community_member

Sorsa の指標： get_sorsa_score、get_sorsa_score_changes、get_followers_stats、 get_top_followers、get_top_following、get_new_followers_7d、get_new_following_7d

リスト： get_list_members、get_list_tweets、get_list_followers

ユーティリティ： username_to_id、id_to_username、link_to_id、get_key_usage_info

プロジェクト構成

• src/endpoints.ts — 各エンドポイント（メソッド、パス、パラメーター）を宣言的に定義したテーブルです。
  ツールを追加または変更する場合は、このファイルだけを編集します。
• src/index.ts — HTTP クライアントと、このテーブルに基づくツール登録を行います。

仕組み

各エンドポイントは ENDPOINTS の 1 つのエントリです。各フィールドの in （path／query／body）に基づき、ハンドラーは引数を URL パス、クエリ文字列、または JSON ボディに振り分け、ApiKey ヘッダーを付けて Sorsa にリクエストを送信します。レスポンスは JSON テキストとしてクライアントに返されます。

ライセンス

MIT