MCP 接入指南

Cursor 一键接入

只需要两步：复制配置 → 粘贴到文件里。

1

复制下面的配置

把 your_api_key 替换成你的 API Key，把 api.yourdomain.com 替换成你的服务地址。

2

粘贴到配置文件

在项目根目录创建 .cursor/mcp.json，把配置粘贴进去。没有这个目录就手动建一个。或者放到全局配置 ~/.cursor/mcp.json。

.cursor/mcp.json

{
  "mcpServers": {
    "twiapi": {
      "url": "https://api.yourdomain.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

把 your_api_key 换成你自己的 Key，把 api.yourdomain.com 换成实际的服务地址。保存后重启 Cursor 即可。

.cursor/mcp.json

{
  "mcpServers": {
    "twiapi": {
      "url": "https://api.yourdomain.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TWIAPI_MCP_KEY}",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

终端设置环境变量

export TWIAPI_MCP_KEY="your_api_key"

环境变量的好处是 Key 不会明文保存在配置文件里，适合多人协作或提交到 Git 的项目。

其他 AI 工具怎么接

如果你用的是 Claude Desktop、ChatGPT、Windsurf 或其他支持 MCP 的工具，接入方式类似——填入 MCP 地址和请求头。

claude_desktop_config.json

{
  "mcpServers": {
    "twiapi": {
      "url": "https://api.yourdomain.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

配置文件路径：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

.windsurf/mcp.json

{
  "mcpServers": {
    "twiapi": {
      "serverUrl": "https://api.yourdomain.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key",
        "MCP-Protocol-Version": "2025-11-25"
      }
    }
  }
}

Python 调用示例

import httpx, json

MCP_URL = "https://api.yourdomain.com/mcp"
API_KEY = "your_api_key"
HEADERS = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}",
    "MCP-Protocol-Version": "2025-11-25",
}

# 1. 初始化
r = httpx.post(MCP_URL, headers=HEADERS, json={
    "jsonrpc": "2.0", "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2025-11-25",
        "capabilities": {},
        "clientInfo": {"name": "my-script", "version": "1.0.0"},
    },
})
print(r.json()["result"]["serverInfo"])

# 2. 通知初始化完成（无需等待响应）
httpx.post(MCP_URL, headers=HEADERS, json={
    "jsonrpc": "2.0",
    "method": "notifications/initialized",
})

# 3. 调用工具 — 查用户信息
r = httpx.post(MCP_URL, headers=HEADERS, json={
    "jsonrpc": "2.0", "id": 2,
    "method": "tools/call",
    "params": {
        "name": "user_info",
        "arguments": {"username": "elonmusk"},
    },
})
result = r.json()["result"]
data = json.loads(result["content"][0]["text"])
print(f"@{data['username']} 粉丝数: {data['followers_count']}")

需要先安装 httpx：pip install httpx。返回数据在 result["content"][0]["text"] 里，是 JSON 字符串，用 json.loads() 解析即可。

LangChain / LangGraph 接入

pip install langchain-mcp-adapters langgraph "langchain[openai]"

# --- agent.py ---
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain.chat_models import init_chat_model

# 1. 配置 TwiAPI MCP 连接
client = MultiServerMCPClient({
    "twiapi": {
        "transport": "http",
        "url": "https://api.yourdomain.com/mcp",
        "headers": {
            "Authorization": "Bearer your_api_key",
            "MCP-Protocol-Version": "2025-11-25",
        },
    }
})

# 2. 加载工具并创建 Agent
tools = await client.get_tools()
model = init_chat_model("openai:gpt-4.1")
agent = create_react_agent(model, tools)

# 3. 使用
result = await agent.ainvoke({
    "messages": "帮我查一下 elonmusk 的粉丝数和最新推文"
})

原理：langchain-mcp-adapters 会自动完成 MCP 初始化、工具发现和调用，你不需要手动写 JSON-RPC。14 个工具会自动变成 LangChain Tool，Agent 根据用户问题自动选择调用。

任何支持远程 MCP (Streamable HTTP) 的工具，接入时需要提供以下信息：

MCP 地址：https://api.yourdomain.com/mcp
请求头：Authorization: Bearer your_api_key
协议版本：2025-11-25
传输方式：Streamable HTTP (JSON-RPC 2.0)

接入后能用哪些功能

共 14 个工具，覆盖推文搜索、用户画像、评论分析、互动者列表和热搜趋势。

功能	工具名	简要说明
推文搜索	tweet_search	按关键词搜索推文
用户推文	user_tweets	获取某人的发推/回复/点赞
推文详情	tweet_detail	单条推文的完整信息
批量推文	tweet_batch	一次获取最多 20 条推文
推文评论	tweet_comments	获取推文下的评论
用户信息	user_info	用户资料、粉丝数等画像
用户搜索	user_search	搜索 Twitter 用户
粉丝列表	user_followers	获取某人的粉丝
蓝 V 粉丝	user_blue_verified_followers	获取某人的蓝 V / 认证粉丝
关注列表	user_following	获取某人关注的人
转发者	tweet_retweeters	谁转发了这条推文
点赞者	tweet_favoriters	谁点赞了这条推文
热搜趋势	get_trends	当前热门趋势话题
列表推文	list_tweets	获取 Twitter 列表里的推文

验证是否接通

在终端运行下面这条命令，如果返回了 JSON 数据，说明连接正常。

终端命令

curl -X POST "https://api.yourdomain.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

如果看到 "tools": [...] 列表，说明接入成功。如果报错，请检查 API Key 和服务地址是否正确。

常见问题

Cursor 里看不到工具？

保存配置文件后需要重启 Cursor，或者关闭项目重新打开。如果还是看不到，检查 JSON 格式是否正确（逗号、引号），以及 MCP 地址是否可以访问。

提示认证失败？

确认 API Key 是有效的，并且没有过期或被停用。可以在管理后台查看 Key 的状态。Header 里的格式必须是 Bearer your_api_key，注意 Bearer 和 Key 之间有一个空格。

本地开发时怎么测试？

把配置里的 https://api.yourdomain.com/mcp 改成 http://127.0.0.1:9833/mcp，其余不变。本地测试时 Key 写明文最方便。

每个工具消耗多少额度？

和直接调用 HTTP API 的额度消耗完全一致，具体参见 API 文档中各接口的「消耗额度」说明。