MCP 服务端 - Twitter 无需认证版

一个基于 Model Context Protocol（模型上下文协议）的服务端，提供无需本地凭证或令牌设置的 Twitter API 访问。支持核心 Twitter 操作，如搜索推文、获取用户推文、发布推文以及回复推文。

演示视频

https://www.youtube.com/watch?v=LOxFqCTPedc

为什么选择 MCP Twitter 无需认证服务器？

核心优势

• 无头远程操作：此服务端可以在完全无图形界面的远程环境中运行，无需浏览器和本地文件访问。
• 解耦架构：支持通过 OAuth2.0 PIN 码授权或应用-only 凭证进行身份验证。

次要优点

• 支持搜索推文、获取用户推文、发布推文以及回复推文等操作。
• 提供自动令牌刷新功能，避免手动操作。

功能概述

• 搜索推文：支持按关键词、用户名或过滤条件（如地理位置）搜索推文。
• 获取用户推文：可以指定用户 ID 或屏幕名称，获取用户的推文和提及内容。
• 发布推文：支持发送普通推文和媒体文件（图片/GIF/视频）。
• 回复推文：可以直接通过推文 ID 发表评论。

先决条件

1. 注册并登录 Twitter Developer Portal
2. 创建新项目和应用，启用 OAuth 2.0 认证。
3. 配置 OAuth 设置，生成客户端 ID 和客户端密钥。
4. 完成 OAuth 流程，获取初始访问令牌和刷新令牌。

安装指南

方式一：直接运行可执行文件

• 下载对应平台的可执行程序（Windows/Linux/MacOS）
• 解压后双击运行即可

方式二：通过源码编译运行

1. 克隆代码仓库
2. 安装依赖项
3. 配置环境变量或修改配置文件，填写您的 Twitter API 凭证
4. 运行服务端程序

Docker 使用说明

# 下载镜像
docker pull buryu/mcp-twitter-noauth

# 启动容器
docker run -d --name mcp-twitter \
    -e CLIENT_ID=your_client_id \
    -e CLIENT_SECRET=your_client_secret \
    -e ACCESS_TOKEN=your_access_token \
    -e REFRESH_TOKEN=your_refresh_token \
    buryu/mcp-twitter-noauth

配置文件说明

{
    "auth": {
        "client_id": "your_client_id",
        "client_secret": "your_client_secret",
        "access_token": "your_access_token",
        "refresh_token": "your_refresh_token"
    },
    "proxy": {
        "enabled": false,
        "host": "",
        "port": 0
    }
}

示例操作

搜索推文

# 命令行调用
curl -X POST http://localhost:8080/api/search \
     -H "Content-Type: application/json" \
     -d '{"query":"#加密","count":10}'

# 或者通过工具调用
{
    "method": "search_tweet",
    "parameters": {
        "query": "#加密",
        "count": 10
    }
}

发布推文

curl -X POST http://localhost:8080/api/post \
     -H "Content-Type: application/json" \
     -d '{"text":"这条推文来自 MCP 服务端"}'

定期维护

令牌管理

1. 建议定期检查令牌的有效期，及时更新刷新令牌。
2. 如果发现令牌被泄露或怀疑安全性问题，请立即重置 OAuth 密钥。

日志监控

建议开启日志记录功能，实时监控 API 调用情况和异常信息：

docker logs -f mcp-twitter

安全提示

• 请勿将 Twitter API 凭证泄露给不可信的第三方。
• 建议在生产环境中使用 HTTPS，并配置 SSL 证书。

许可证

详细内容请参阅 LICENSE 文件。