项目简介

这是一个基于Model Context Protocol (MCP) 的服务器实现,专门用于集成Twitter/X服务。它允许支持MCP协议的客户端(如某些LLM接口)通过服务器提供的工具向Twitter发布内容,为LLM提供与Twitter交互的能力。

主要功能点

  • 推文发布工具: 提供一个名为 'create-post-on-twitter' 的工具,LLM可以通过调用此工具并提供文本内容来向Twitter发布推文。
  • 动态资源: 包含一个简单的动态资源 'greeting://{name}',用于演示资源访问功能。

安装步骤

  1. 克隆仓库到本地。
  2. 进入项目目录。
  3. 安装依赖:运行命令 'pnpm install'。
  4. 获取Twitter API密钥:访问 Twitter Developer Portal 获取 'CONSUMER_KEY', 'CONSUMER_SECRET', 'TWITTER_ACCESS_TOKEN', 'TWITTER_ACCESS_SECRET'。
  5. 在项目根目录创建 '.env' 文件,并将获取的密钥按以下格式填入:
    CONSUMER_KEY="你的消费密钥"
    CONSUMER_SECRET="你的消费密钥密文"
    TWITTER_ACCESS_TOKEN="你的访问令牌"
    TWITTER_ACCESS_SECRET="你的访问令牌密文"
  6. 构建项目:运行命令 'pnpm build'。

服务器配置

MCP服务器通常需要由兼容的MCP客户端启动和管理。在客户端的配置中(例如,如果你使用VS Code GitHub Copilot,则在其 'settings.json' 文件中),你需要指定如何启动这个服务器。配置大致如下:

// 在你的MCP客户端配置中找到相关部分,通常是一个 "mcp" 对象
"mcp": {
  "servers": {
    "mcp-twitter-server": { // 这是你在客户端中为此服务器指定的名称,可自定义
      "command": "node", // 启动服务器的命令,这里是node
      "args": ["/你的/项目/路径/MCP-Server-of-X/build/index.js"] // 启动命令的参数,指向构建后的服务器主程序路径
    }
    // 如果你有其他MCP服务器,可以在这里添加更多配置项
  }
}

请将 '/你的/项目/路径/MCP-Server-of-X' 替换为你实际克隆该仓库的本地路径。这个配置告诉客户端如何找到并启动这个MCP服务器进程。

基本使用方法

配置并启动MCP客户端后,客户端会自动检测并启动配置好的MCP服务器。服务器启动后会向客户端声明其提供的能力(工具和资源)。兼容的LLM模型通过客户端感知到 'create-post-on-twitter' 工具的存在,并能在合适的上下文(例如,用户提出“帮我发一条推文”)下,通过客户端调用该工具,将用户提供的文本内容作为参数传递,从而实现推文的发布。同时,也可以通过访问 'greeting://你的名字' 这样的URI来测试动态资源的获取。

信息

分类

通信与社交