twitterapi-docs-mcp（在 GitHub 仓库中也称为 twitterapi-io-mcp）是一个 MCP（Model Context Protocol）服务器，为 Claude、Cursor、VS Code Copilot 等 AI 助手提供 TwitterAPI.io 的离线文档访问能力。它由社区开发者独立维护，与 TwitterAPI.io 官方无隶属关系。
用途 该工具的核心用途是让 AI 助手在本地即时获取 TwitterAPI.io 的完整文档，避免开发者在编辑器和文档网站之间来回切换。当你的 AI 助手支持 MCP 时，它可以直接读取打包好的文档快照，无需网络请求，也无需配置任何 API 密钥。
主要能力 仓库资料显示，该 MCP 服务器本地打包了以下内容：
- 67 个活跃的 API 端点，包含完整的 HTTP 方法、请求体/查询参数、cURL 示例和响应结构。
- 32 个指南页面，覆盖定价、身份验证、速率限制、Webhook、流式传输等主题。
- 24 篇博客文章，提供教程和使用案例。
- 所有 v2 写端点都记录了 login_cookies、proxy 和 body 参数。
- 已移除所有废弃的 v1 端点，仅保留当前的 v2 端点。
该服务器提供的工具包括用于查询指南、端点、认证、定价、端点列表和文档搜索的函数。资料中提及的可用工具类型有：get_twitterapi_guide、get_twitterapi_endpoint、get_twitterapi_auth、get_twitterapi_pricing、list_twitterapi_endpoints、search_twitterapi_docs。搜索支持模糊匹配和错字容忍，建议使用 max_results: 5 获取聚焦结果。
使用方式 需要 Node.js 18.18.0 或更高版本。npm 包名为 twitterapi-io-mcp。
在 Claude Code 中，将配置添加到对应系统的 config 文件： macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json Linux：~/.config/Claude/claude_desktop_config.json
在 Cursor 中，将配置添加到项目根目录的 .cursor/mcp.json。 在 VS Code / VS Code Insiders 中，将配置添加到项目根目录的 .vscode/mcp.json。 在 Windsurf 中，将配置添加到 ~/.codeium/windsurf/mcp_config.json。 也可以从源码构建。
如果 AI 工具不支持 MCP（如 OpenClaw），可使用 Skill 版本：dorukardahan/twitterapi-io-skill，这是一个包含全部 67 个活跃端点的单 markdown 文件，适用于 OpenClaw、Claude、GPT、Gemini 及任何 LLM。
典型提问示例（来自资料）：
- “TwitterAPI.io 的速率限制是多少？” 触发 get_twitterapi_guide
- “显示推文高级搜索端点” 触发 get_twitterapi_endpoint
- “如何通过 API 进行认证？” 触发 get_twitterapi_auth
- “定价是多少？” 触发 get_twitterapi_pricing
- “列出所有用户相关端点” 触发 list_twitterapi_endpoints，category: “user”
- “Webhook 过滤规则如何工作？” 触发 search_twitterapi_docs
- “哪些写端点需要登录？” 触发 search_twitterapi_docs，query: “login_cookies”
- “如何上传媒体并创建推文？” 触发顺序调用 get_twitterapi_endpoint
适用场景 适合正在使用 TwitterAPI.io 进行 Twitter/X API 开发的开发者，在编写代码时通过 AI 助手快速查询端点参数、认证方式、速率限制、定价和 Webhook 配置等文档信息。也适用于需要离线查阅文档、不希望配置 API 密钥或进行实时 API 调用的场景。
限制与注意事项
- 该服务器只提供文档快照，不代理实时 API 调用，因此不能通过它直接调用 TwitterAPI.io 接口。
- 文档内容基于打包时的快照，可能滞后于官方最新文档，使用前应留意版本更新。
- 项目为独立社区项目，与 TwitterAPI.io 无官方关联。
- 需要 Node.js 18.18.0 或更高版本。
- 首次运行 npx 会从 npm 下载包，可能耗时；若卡住可尝试全局安装：npm install -g twitterapi-io-mcp。
- 在 MCP 客户端添加服务器配置后，多数客户端需要重启才能检测到新服务器。
- 资料提到平台建议：Twitter 已禁用 since:/until: 搜索操作符，改用 since_time:UNIX / until_time:UNIX。
版本历史摘要
- v1.2.0：OpenAPI 优先的 scraper 重写，结构化参数类型、响应结构，消除 Vercel 检查点问题。
- v1.1.x：新增 list_timeline 与 get_user_timeline，移除 7 个废弃 V1 端点，安全修复（hono、ajv、express-rate-limit）。
- v1.0.23：平台建议——Twitter 禁用 since:/until: 搜索操作符，改用 since_time:UNIX / until_time:UNIX。
- v1.0.22：新增 7 个端点（get_space_detail、get_tweet_replies_v2、get_user_about 等）。
