Sorsa Api Mcp

Sorsa MCP

一个用于 Sorsa.io API v3 的 MCP 服务 — 可访问 X/Twitter 数据：个人资料、推文、搜索、关注/转推检查、Sorsa 评分、列表和社群。

该服务提供 40 个工具，每个 API 端点对应一个工具。

安装

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 中的一个条目。处理程序根据各字段的 in （path / query / body），将参数路由到 URL 路径、查询字符串或 JSON 请求体中， 然后在请求中加入 ApiKey 标头并发送至 Sorsa。响应以 JSON 文本形式返回给客户端。

许可证

MIT