mcp-x MCP server

mcp-x MCP server

site icon
2024.12.28 4
Python社交媒体管理API集成交流协作
mcp-x是一个MCP服务器项目,旨在连接Claude与X API(原Twitter API)。该项目基于X API v2构建,支持基本的推文发布功能,并计划扩展更多社交媒体交互功能。
View on GitHub

Overview

基本能力

产品定位

mcp-x是一个桥梁服务,专门用于在Claude和X平台(原Twitter)之间建立连接,实现自动化社交媒体交互。

核心功能

  • 发布推文(Post tweets)
  • 计划支持获取推文(Get tweets)
  • 计划支持删除推文(Delete tweets)

适用场景

  • 自动化社交媒体内容发布
  • Claude与X平台的数据交互
  • 社交媒体管理工具集成

工具列表

  • X API v2:提供与X平台交互的核心API接口
  • uvicorn:用于运行Python应用的ASGI服务器

常见问题

  • 需要获取X开发者平台的API密钥
  • 配置路径因操作系统而异(MacOS/Windows)
  • 目前功能仍在扩展中(TODO列表)

使用教程

使用依赖

  1. 访问X开发者平台并登录
  2. 选择Basic计划
  3. 获取并保存以下凭证:
  4. Access Token
  5. Secret
  6. Client ID
  7. Client Secret
  8. Bearer token

安装教程

  1. 配置Claude桌面配置文件:
  2. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

  4. 配置JSON示例:

{
  "mcpServers": {
    "x": {
      "command": "uv",
      "args": [
        "--directory",
        "PROJECT_PATH/src/mcp_x",
        "run",
        "mcp-x"
      ],
      "env": {
        "X_API_KEY": "YOUR_API_KEY",
        "X_API_KEY_SECRET": "YOUR_API_KEY_SECRET",
        "X_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN",
        "X_ACCESS_TOKEN_SECRET": "YOUR_ACCESS_TOKEN_SECRET",
        "X_BEARER_TOKEN": "YOUR_BEARER_TOKEN",
        "LOGGING_PATH": "PROJECT_PATH/src/mcp_x/logs"
      }
    }
  }
}

调试方式

  1. 同步依赖并更新锁文件:
uv sync
  1. 构建包分发:
uv build
  1. 构建完成后,可在dist/目录中找到源和wheel分发文件。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。