x-autonomous-mcp

使用说明（简要且易上手）：

• 项目简介

  • 该仓库实现了一个完整的 MCP 服务器，用于向 LLM 客户端提供上下文信息和功能。核心能力包括资源/resource 管理、工具/tool 注册与执行、以及 Prompts 的渲染与管理；并通过 JSON-RPC 与客户端通信，支持会话管理与能力声明。

• 主要功能点

  • 资源与数据访问：内置状态管理、预算与互动记录，用于控制每日额度与去向。
  • 工具注册与执行：实现了多种工具，例如 post_tweet、get_tweet、search_tweets、get_user、follow/unfollow、like/retweet 等，具备参数校验、错误提示、以及预算/去重等安全机制。
  • 工作流系统：内置 follow_cycle、reply_track 等工作流，支持自动执行、排队、自动推进，以及给 LLM 任务的分发。
  • Prompts 渲染与 TOON 编码：支持 TOON（Token-Oriented Object Notation）和 JSON 两种返回格式，便于不同客户端的 token 效率与可读性。
  • JSON-RPC 通信：服务器以 MCP 的风格暴露工具接口，客户端通过标准的 JSON-RPC 调用进行操作。
  • 安全与治理：每日预算、去重、受保护账户、队列机制、错误提示以及容错处理等。

• 安装步骤

  • 克隆仓库后，进入项目目录并安装依赖。
  • 构建项目以生成可执行输出。
  • 启动 MCP 服务器进程。

• 服务器配置（供 MCP 客户端使用的配置示例，格式为 JSON，包含 server name、command、args 等信息） { "server_name": "x-autonomous-mcp", "command": "node", "args": ["dist/index.js"], "description": "启动 MCP 服务器，基于 StdIO 传输与 JSON-RPC 协议对接 MCP 客户端" }

• 基本使用方法

  • 依赖与构建
    • 安装依赖并构建产物，例如 npm install 以及 npm run build。
  • 启动服务器
    • 使用 Node 直接运行打包输出（如 node dist/index.js），服务器会通过 StdIO 传输方式对外提供 MCP 服务。
  • 客户端连接
    • MCP 客户端应通过 JSON-RPC 调用与服务器通信，执行资源、工具、Prompts 的读取与执行，并通过服务器返回的封装格式获得结果。
  • 配置与环境
    • 服务器运行时需要 X API 的凭证（如 API Key、Secret、Bearer Token、Access Token/Secret 等）以及可选的预算、保护账户等环境变量。客户端无需关心服务器内部实现细节，只需按服务器提供的接口进行调用。

• 运行与测试提示

  • 仓库包含丰富的单元测试与集成测试，用于验证工作流、工具、预算、去重等逻辑的正确性。实际运行时请确保依赖就绪并按 README 指南配置环境变量。