项目简介
这是一个基于Model Context Protocol (MCP) 的服务器实现,专门用于集成Twitter/X服务。它允许支持MCP协议的客户端(如某些LLM接口)通过服务器提供的工具向Twitter发布内容,为LLM提供与Twitter交互的能力。
主要功能点
- 推文发布工具: 提供一个名为 'create-post-on-twitter' 的工具,LLM可以通过调用此工具并提供文本内容来向Twitter发布推文。
- 动态资源: 包含一个简单的动态资源 'greeting://{name}',用于演示资源访问功能。
安装步骤
- 克隆仓库到本地。
- 进入项目目录。
- 安装依赖:运行命令 'pnpm install'。
- 获取Twitter API密钥:访问 Twitter Developer Portal 获取 'CONSUMER_KEY', 'CONSUMER_SECRET', 'TWITTER_ACCESS_TOKEN', 'TWITTER_ACCESS_SECRET'。
- 在项目根目录创建 '.env' 文件,并将获取的密钥按以下格式填入:
CONSUMER_KEY="你的消费密钥" CONSUMER_SECRET="你的消费密钥密文" TWITTER_ACCESS_TOKEN="你的访问令牌" TWITTER_ACCESS_SECRET="你的访问令牌密文" - 构建项目:运行命令 '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来测试动态资源的获取。
信息
分类
通信与社交