项目简介

twitter-mcp 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供与 Twitter 平台交互的能力。通过集成 Twitter API，该服务器实现了发布推文和搜索推文的功能，使得 LLM 应用能够便捷地获取和利用 Twitter 的数据与服务。

主要功能点

推文发布 (post_tweet): 允许 LLM 客户端调用工具发布新的推文到 Twitter。
推文搜索 (search_tweets): 允许 LLM 客户端调用工具在 Twitter 上搜索推文，并返回搜索结果。
MCP 协议兼容: 遵循 MCP 协议标准，通过 JSON-RPC 与客户端通信，提供工具注册和执行能力。
Stdio 传输协议: 使用 Stdio 作为默认传输协议，方便集成到支持 Stdio MCP 客户端的应用中。
错误处理和日志: 具备完善的错误处理机制，能够处理 Twitter API 错误和 MCP 协议错误，并提供日志记录功能方便问题排查。

安装步骤

克隆仓库:

git clone https://github.com/MCP-Mirror/EnesCinr_twitter-mcp.git
cd EnesCinr_twitter-mcp

安装依赖: 确保已安装 Node.js 和 npm，然后运行以下命令安装项目依赖：
```
npm install
```
构建项目: 运行以下命令构建项目，生成可执行文件：
```
npm run build
```

服务器配置

要将 twitter-mcp 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要编辑客户端的配置文件，添加 'mcpServers' 配置项。以下是针对 Claude Desktop 的配置示例，通常配置文件位于：

Windows: '%APPDATA%\Claude\claude_desktop_config.json' macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

在配置文件中添加或修改 'mcpServers' 部分，加入 'twitter-mcp' 服务器的配置：

{
  "mcpServers": {
    "twitter-mcp": {
      "command": "npx",  // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": ["-y", "@enescinar/twitter-mcp"], // 传递给命令的参数，-y 表示自动确认安装 @enescinar/twitter-mcp 包
      "env": {
        "API_KEY": "YOUR_TWITTER_API_KEY",       // 替换为你的 Twitter API 密钥
        "API_SECRET_KEY": "YOUR_TWITTER_API_SECRET_KEY", // 替换为你的 Twitter API 密钥密文
        "ACCESS_TOKEN": "YOUR_TWITTER_ACCESS_TOKEN",    // 替换为你的 Twitter 访问令牌
        "ACCESS_TOKEN_SECRET": "YOUR_TWITTER_ACCESS_TOKEN_SECRET" // 替换为你的 Twitter 访问令牌密文
      }
    }
  }
}

注意:

你需要在 Twitter Developer Portal 创建一个 Twitter 开发者账号并获取 API 密钥、API 密钥密文、访问令牌和访问令牌密文。
请将 'YOUR_TWITTER_API_KEY', 'YOUR_TWITTER_API_SECRET_KEY', 'YOUR_TWITTER_ACCESS_TOKEN', 和 'YOUR_TWITTER_ACCESS_TOKEN_SECRET' 替换为你自己的 Twitter API 凭据。

基本使用方法

配置完成后，重启 MCP 客户端。客户端应该能够检测到 'twitter-mcp' 服务器提供的工具。

示例用法 (在 Claude Desktop 中):

发布推文: 你可以向 Claude 提出类似这样的问题：

请使用 post_tweet 工具发布一条推文，内容是 "Hello from Claude!"

搜索推文: 你可以向 Claude 提出类似这样的问题：

请使用 search_tweets 工具搜索关于 Claude AI 的推文，返回 20 条结果。

客户端会将这些自然语言指令转换为对 'post_tweet' 或 'search_tweets' 工具的调用，并使用 twitter-mcp 服务器与 Twitter API 交互，最终将结果返回给你。

日志查看

服务器的日志文件位于：

Windows: '%APPDATA%\Claude\logs\mcp-server-twitter.log' macOS: '~/Library/Logs/Claude/mcp-server-twitter.log'

可以通过查看日志文件来诊断服务器运行问题。

关键词