TwitterAPI MCP Server

TwitterAPI MCP服务器

一个模型上下文协议（MCP）服务器，通过 推特API.io 服务。此服务器使Claude和其他MCP客户端能够与Twitter的生态系统进行交互，而无需Twitter开发人员帐户批准。

归因这个项目是 下载 kinhunt/twitterapi-mcp 修复了错误并进行了改进，以与官方TwitterAPI.io文档相匹配。

特性

• 用户信息：获取详细的用户资料、关注者和以下列表
• 推特操作：搜索推文，获取推文详细信息、回复和用户时间线
• 搜索功能：推文和用户的高级搜索
• 写入操作：发布推文并与内容互动（需要登录）
• 分页支持：所有列表端点都支持基于光标的分页
• 企业就绪：代理支持和强大的错误处理
• 无Twitter身份验证：使用TwitterAPI.io，不需要Twitter开发人员批准

安装

npx快速入门（推荐）

npx twitterapi-mcp-server

全球安装

npm install -g twitterapi-mcp-server

本地安装

npm install twitterapi-mcp-server

配置

获取API密钥

1. 访问 推特API.io
2. 创建帐户并登录
3. 从仪表板获取API密钥
4. API密钥格式如下所示： new1_xxxxxxxxxxxxxxxxxxxxx

环境变量

MCP客户端配置

克劳德桌面版

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "twitterapi": {
      "command": "npx",
      "args": ["-y", "twitterapi-mcp-server"],
      "env": {
        "TWITTERAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}

带代理的Claude桌面

{
  "mcpServers": {
    "twitterapi": {
      "command": "npx",
      "args": ["-y", "twitterapi-mcp-server"],
      "env": {
        "TWITTERAPI_API_KEY": "your_api_key_here",
        "PROXY_URL": "http://proxy.company.com:8080"
      }
    }
  }
}

光标IDE

添加到光标MCP设置(.cursor/mcp.json):

{
  "mcpServers": {
    "twitterapi": {
      "command": "npx",
      "args": ["-y", "twitterapi-mcp-server"],
      "env": {
        "TWITTERAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}

克劳德代码

添加到您的Claude Code MCP设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "twitterapi": {
      "command": "npx",
      "args": ["-y", "twitterapi-mcp-server"],
      "env": {
        "TWITTERAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}

直接与Node一起使用

如果您更喜欢直接使用Node而不是npx运行：

{
  "mcpServers": {
    "twitterapi": {
      "command": "node",
      "args": ["/path/to/twitterapi-mcp-server/build/index.js"],
      "env": {
        "TWITTERAPI_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

用户信息

推特操作

写入操作（需要登录）

例子

获取用户信息

// Get user by username
await get_user_by_username({ username: "elonmusk" })

// Get user followers with pagination
await get_user_followers({
  username: "elonmusk",
  pageSize: 100
})

// Get next page using cursor
await get_user_followers({
  username: "elonmusk",
  cursor: "next_cursor_from_previous_response"
})

搜索和检索推文

// Search latest tweets
await search_tweets({
  query: "artificial intelligence",
  queryType: "Latest"
})

// Search top/popular tweets
await search_tweets({
  query: "OpenAI",
  queryType: "Top"
})

// Advanced search with operators
await search_tweets({
  query: "AI from:elonmusk since:2024-01-01"
})

// Get user's recent tweets
await get_user_tweets({ username: "openai" })

// Get user's tweets including replies
await get_user_tweets({
  username: "openai",
  includeReplies: true
})

// Get specific tweets by IDs
await get_tweet_by_id({
  tweet_ids: ["1234567890123456789", "9876543210987654321"]
})

// Get replies to a tweet
await get_tweet_replies({
  tweetId: "1234567890123456789"
})

创建内容（需要登录）

// Login first (requires residential proxy)
await login_user({
  user_name: "your_username",
  email: "your_email@example.com",
  password: "your_password",
  proxy: "http://user:pass@proxy:port"
})

// Post a tweet
await create_tweet({
  tweet_text: "Hello from MCP!",
  proxy: "http://user:pass@proxy:port"
})

// Reply to a tweet
await create_tweet({
  tweet_text: "Great point!",
  reply_to_tweet_id: "1234567890123456789",
  proxy: "http://user:pass@proxy:port"
})

分页

所有列表端点都返回基于光标导航的分页结果：

{
  "data": [...],
  "has_next_page": true,
  "next_cursor": "cursor_string_for_next_page"
}

要获取下一页，请传递 next_cursor 值为 cursor 参数在您的下一个请求中。

API定价

TwitterAPI.io提供按需付费的定价：

• 最低费用：每次请求0.00015美元
• 无月费
• 免费试用积分
• 学生和研究机构的折扣率

发展

从源头构建

git clone https://github.com/Jing-yilin/twitterapi-mcp-server.git
cd twitterapi-mcp-server
npm install
npm run build

运行测试

# Using bun
bun test

# Or with npm (requires bun installed)
npm test

手动测试服务器

# Set your API key
export TWITTERAPI_API_KEY="your_api_key"

# Test tools list
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | node build/index.js

# Test a tool call
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_user_by_username", "arguments": {"username": "elonmusk"}}}' | node build/index.js

项目结构

twitterapi-mcp-server/
├── src/
│   ├── index.ts           # Main server implementation
│   ├── index.test.ts      # Unit tests
│   └── integration.test.ts # Integration tests
├── build/                  # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

错误处理

服务器处理常见错误：

安全考虑

• 将API键存储为环境变量，从不存储在代码中
• 登录凭据仅用于身份验证，而不是持久存储
• 所有API请求都使用HTTPS
• 代理支持可满足企业安全要求
• 这 login_cookie 来自登录的信息仅存储在会话的内存中

故障排除

“未经授权”错误

• 验证您的API密钥是否正确
• 检查一下 TWITTERAPI_API_KEY 环境变量已设置

“积分不足”错误

• 将点数添加到您的TwitterAPI.io帐户
• 在仪表板上查看您的使用情况

服务器未启动

• 确保已安装Node.js>=18.0.0
• 跑 npm run build 编译TypeScript
• 检查stderr中的错误消息

代理问题

• 验证代理URL格式： http://user:pass@host:port
• 独立测试代理连接
• 对于HTTPS代理，请使用 HTTPS_PROXY 变量

贡献

1. 复刻仓库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

• API文档: 文档.twitterapi.io
• 问题:
• TwitterAPI.io支持: 网站 twitterapi.io

致谢

• 最初分叉自 下载 kinhunt/twitterapi-mcp
• 建立在 推特API.io 服务
• 使用 模型上下文协议
• 成长中的MCP生态系统的一部分

______________________________________________________________________

备注：这是TwitterAPI.io的非官方MCP服务器。使用此工具时，请确保遵守Twitter的服务条款。