项目简介

本项目是一个实现了 Model Context Protocol (MCP) 的服务器端应用。它通过 MCP 协议向外部 LLM 客户端提供特定的功能，核心能力是封装了与 X (Twitter) API 的交互，允许 LLM 调用工具来发布推文。

主要功能点

• MCP Tool 实现: 暴露了一个名为 'createPost' 的 MCP Tool，允许客户端通过标准化的 MCP 请求调用此功能。
• X (Twitter) API 交互: 封装了使用 Twitter API 发布推文的逻辑，处理认证和发帖过程。
• SSE 传输协议: 支持 Server-Sent Events (SSE) 作为与 MCP 客户端通信的传输层。
• 标准化接口: 符合 MCP 规范，使 LLM 客户端能够发现、理解和调用服务器提供的功能。

安装步骤

1. 确保您已安装 Node.js 和 npm/yarn。
2. 克隆本项目仓库到本地。

   git clone <仓库URL>
   cd MCP-Quantum-Server
   

3. 安装项目依赖。

   npm install # 或 yarn install
   

4. 在项目根目录创建 '.env' 文件，并配置您的 X (Twitter) API 凭据。请确保您拥有开发账户并已生成相应的 API 密钥和访问令牌。

   TWITTER_API_KEY=您的API Key
   TWITTER_API_SECRET=您的API Secret
   TWITTER_ACCESS_TOKEN=您的Access Token
   TWITTER_ACCESS_SECRET=您的Access Secret
   

5. 启动 MCP 服务器。

   node Server/x_server/index.ts
   

   服务器默认将在端口 '3001' 上运行。

服务器配置

MCP 客户端需要知道如何启动并连接到服务器。对于此服务器，客户端通常需要以下配置信息（这些信息通常在 MCP 客户端的配置文件中设置）：

• 'name': 服务器的唯一标识符，例如 "x-post-server"。
• 'command': 启动服务器进程的命令，例如 "node"。
• 'args': 传递给启动命令的参数列表，指定要执行的脚本文件，例如 '["Server/x_server/index.ts"]'。
• 'transport': 客户端与服务器建立连接的方式。对于此服务器，应配置为 SSE 传输协议，指定类型 ('type: "sse"') 和连接 URL ('url: "http://localhost:3001/sse"')。

请根据您的 MCP 客户端的具体配置方式，填入上述信息。

基本使用方法

1. 按照安装步骤启动 MCP 服务器。
2. 配置并启动您的 MCP 客户端，使其能够发现并连接到此服务器。
3. 通过 MCP 客户端（通常是与 LLM 集成的应用），您可以列出服务器提供的工具。您将发现一个名为 'createPost' 的工具。
4. 当您希望通过 LLM 发布一条推文时，LLM 客户端可以通过 MCP 协议调用 'createPost' 工具。调用时需要提供一个参数对象，该对象包含一个名为 'status' 的字段，其值即为您希望发布的推文内容。 例如，LLM 可能会构造一个工具调用请求，其参数类似 '{"status": "Hello, world! This is a tweet from an LLM via MCP."}'。
5. 服务器接收到请求后，将使用您在 '.env' 文件中配置的 Twitter 凭据调用 Twitter API 发布推文，并将发帖结果通过 MCP 协议返回给客户端。