使用说明
🐦 X-Post MCP🚀
一个强大的集成，允许AI模型使用模型上下文协议（MCP）直接发布到X（以前的推特）🤖✨
📋 概述
X-Post MCP是一个客户端-服务器应用程序，它使AI模型能够通过标准化的界面在X（以前的推特）上创建和发布帖子。它利用模型上下文协议在AI模型和X平台之间提供无缝集成。
✨ 特性
- 🔄 与X（Twitter）API无缝集成
- 🧠 基于谷歌Gemini模型的人工智能帖子创建
- 🛠️ MCP服务器将X发布功能作为工具公开
- 💬 用于测试和演示的交互式聊天界面
- 🔒 安全处理API证书
- ✂️ 自动截断超过X字符限制的帖子
🛠️ 技术
- 包子：快速的一体化JavaScript运行时
- TypeScript：类型安全的JavaScript
- 快速：Node.js的Web框架
- 模型上下文协议（MCP）：人工智能环境的标准化协议
- Twitter API v2：X平台API
- 谷歌双子座：谷歌的生成式人工智能模型
📦 安装
先决条件
- 包子 v1.2.5或更高版本
- X（Twitter）API证书
- Google Gemini API密钥
服务器安装程序
# Clone the repository
git clone https://github.com/subhadeeproy3902/x-post-mcp.git
cd x-post-mcp
# Install server dependencies
cd server
bun install
客户端设置
# From the project root
cd client
bun install
⚙️ 配置
获取X（Twitter）API证书
-
创建开发人员帐户:
- 转到 X开发者门户
- 使用您的X帐户登录或创建新帐户
- 如果您还没有开发人员帐户，请申请一个
-
创建项目和应用程序:
- 批准后，在开发人员门户中创建一个新项目
- 在项目中，创建一个新的应用程序
- 为您的应用程序命名和描述
-
设置应用程序权限:
- 在您的应用程序设置中，导航到“用户身份验证设置”部分
- 编辑设置并启用OAuth 1.0a
- 将应用程序权限设置为 读写和发送消息
- 保存您的更改
-
生成访问令牌:
- 导航到“密钥和令牌”选项卡
- 生成“消费者密钥”（API密钥和秘密）
- 为您的帐户生成“访问令牌和密码”
- 确保保存所有四个值，因为配置需要它们
⚠️ 重要：确保API密钥和令牌的安全，永远不要将它们提交到公共存储库。
服务器环境变量
创建一个 .env 文件在 server 包含以下变量的目录：
# X (Twitter) API Credentials
TWITTER_API_KEY=your_twitter_api_key
TWITTER_API_SECRET=your_twitter_api_secret
TWITTER_ACCESS_TOKEN=your_twitter_access_token
TWITTER_ACCESS_SECRET=your_twitter_access_secret
获取Google Gemini API密钥
⚠️ 重要：确保API密钥的安全，永远不要将其提交到公共存储库。
客户端环境变量
创建一个 .env 文件在 client 包含以下变量的目录：
# Google Gemini API Key
GEMINI_API_KEY=your_gemini_api_key
🚀 用法
启动服务器
cd server
bun run dev
服务器将于启动 http://localhost:3001.
启动客户端
cd client
bun run index.ts
客户端将连接到服务器并提供一个交互式聊天界面，您可以在其中与AI模型交互并指示它发布到X。
示例命令
客户端运行后，您可以与AI模型进行交互：
You: Post a tweet about the beautiful weather today
AI将使用Gemini模型生成帖子，然后使用MCP工具将其发布到X。
🏗️ 建筑
服务器
服务器组件使用Express构建，并实现模型上下文协议。它公开了一个名为 createPost 服务器使用服务器发送事件（SSE）与客户端进行通信。
客户端
客户端组件连接到MCP服务器，并提供与谷歌Gemini AI模型交互的接口。它将用户请求转换为人工智能生成的内容，并可以调用服务器的工具发布到X。
🤝 贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
🙏 致谢
- 模型上下文协议 用于提供标准化的AI上下文协议
- Twitter API v2 用于X平台集成
- 谷歌双子座 人工智能能力
