X Post MCP

🐦 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证书

1. 创建开发人员帐户:

- 转到 X开发者门户 - 使用您的X帐户登录或创建新帐户 - 如果您还没有开发人员帐户，请申请一个

1. 创建项目和应用程序:

- 批准后，在开发人员门户中创建一个新项目 - 在项目中，创建一个新的应用程序 - 为您的应用程序命名和描述

1. 设置应用程序权限:

- 在您的应用程序设置中，导航到“用户身份验证设置”部分 - 编辑设置并启用OAuth 1.0a - 将应用程序权限设置为 读写和发送消息 - 保存您的更改

1. 生成访问令牌:

- 导航到“密钥和令牌”选项卡 - 生成“消费者密钥”（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密钥

1. 创建Google AI Studio帐户:

- 首选 谷歌人工智能工作室 - 使用您的Google帐户登录

1. 获取API密钥:

- 导航到 API密钥部分 - 单击“创建API密钥” - 复制新的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。

🤝 贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

🙏 致谢

• 模型上下文协议 用于提供标准化的AI上下文协议
• Twitter API v2 用于X平台集成
• 谷歌双子座 人工智能能力