JinDaGe - Twitter NoAuth MCP Details

article

README

🚀 MCP 服务端 - Twitter 无需认证版

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

🚀 快速开始

本服务端提供无需本地凭证或令牌设置的 Twitter API 访问，支持多种 Twitter 核心操作。您可以通过以下链接查看演示视频：演示视频

✨ 主要特性

核心优势

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

次要优点

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

功能概述

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

📦 安装指南

先决条件

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

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

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

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

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

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

💻 使用示例

基础用法

搜索推文

# 命令行调用
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 服务端"}'

📚 详细文档

配置文件说明

{
    "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
    }
}

定期维护

令牌管理

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

日志监控

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

docker logs -f mcp-twitter

安全提示

⚠️ 重要提示

请勿将 Twitter API 凭证泄露给不可信的第三方。

💡 使用建议

建议在生产环境中使用 HTTPS，并配置 SSL 证书。

📄 许可证

详细内容请参阅 LICENSE 文件。

Twitter NoAuth