Twitter NoAuth

🚀 MCP 服務端 - Twitter 無需認證版

一個基於 Model Context Protocol（模型上下文協議）的服務端，提供無需本地憑證或令牌設置的 Twitter API 訪問。支持搜索推文、獲取用戶推文、發佈推文以及回覆推文等核心 Twitter 操作。

🚀 快速開始

本服務端提供無需本地憑證或令牌設置的 Twitter API 訪問，支持多種 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

💻 使用示例

基礎用法

搜索推文

# 命令行調用
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
    }
}

定期維護

令牌管理

1. 建議定期檢查令牌的有效期，及時更新刷新令牌。
2. 如果發現令牌被洩露或懷疑安全性問題，請立即重置 OAuth 密鑰。

日誌監控

建議開啟日誌記錄功能，即時監控 API 調用情況和異常信息：

docker logs -f mcp-twitter

安全提示

⚠️ 重要提示

請勿將 Twitter API 憑證洩露給不可信的第三方。

💡 使用建議

建議在生產環境中使用 HTTPS，並配置 SSL 證書。

📄 許可證

詳細內容請參閱 LICENSE 文件。