Avalogica X MCP

Avalogic X MCP

版本： 0.1.0

Avalogica X MCP服务器提供与X（Twitter）的集成，允许客户端链接帐户、发布更新、获取最新帖子和总结帖子历史。它遵循模型上下文协议（MCP）规范，并与Atlas、Dedalus SDK和其他兼容客户端配合使用。

______________________________________________________________________

特性

• 通过OAuth2/PKCE链接X帐户
• 发布X的更新
• 获取最近的帖子
• 总结最近的帖子历史（语气、主题、兴趣）
• 具有a/health路由的双传输（STDIO和HTTP）

______________________________________________________________________

先决条件

• Node.js 18或更高版本
• OpenAI API密钥(OPENAI_API_KEY)
• X OAuth客户端凭据(X_CLIENT_ID, X_CLIENT_SECRET)

______________________________________________________________________

配置

使用以下命令创建.env文件：

OPENAI_API_KEY=...
X_CLIENT_ID=...
X_CLIENT_SECRET=...
PORT=3002
NODE_ENV=development

______________________________________________________________________

构建与运行

npm run build
npm run start            # starts HTTP transport on port 8080 by default
npm run dev:stdio        # run via STDIO (useful with the MCP Inspector)
npm run dev:shttp        # HTTP transport with live TypeScript reloading

HTTP服务器公开：

• GET /health → 返回一个JSON有效载荷，确认准备就绪。
• POST /mcp /服务器发送事件 /sse 对于MCP客户。

______________________________________________________________________

工具

link_x_account

• 说明： 启动OAuth2/PKCE流以链接X帐户。

post_to_x

• 说明： 向链接的X帐户发布新更新。

get_recent_posts

• 说明： 从链接的X帐户检索最近的帖子。

summarize_post_history

• 说明： 提供最近帖子历史的摘要，包括语气、主题和兴趣。

______________________________________________________________________

开发说明

• 代码库仍然是ESM("type": "module").
• npm run build 将TypeScript编译为 dist/ 并调整CLI可执行位。
• STDIO传输可以用MCP检查器进行测试： npm run build && npm run inspector.

______________________________________________________________________

许可证

麻省理工学院©马歇尔·D·威尔曼