X集成服务

Avalogica X MCP服务器提供与X(Twitter)的集成服务,允许用户链接账户、发布更新、获取近期帖子并总结发布历史。

  • by mdwillman
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mdwillman/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·威尔曼