NULL EPOCH MCP 服务器 (TNE-SDK 内置实现)

关键词

本地服务器JSON-RPC实时通信开发工具AI 集成

使用说明（Markdown 格式）

项目简介

  • 这是一个基于 MCP 的本地服务器实现，允许 MCP 客户端通过标准的 JSON-RPC 流程与 The Null Epoch 游戏 REST API 进行交互。核心功能包括注册服务器、列出可用工具、按工具调用执行操作、以及服务器到客户端的通知交互。

主要功能点

  • 支持 MCP 的核心请求类型：initialize、tools/list、tools/call、notifications/initialized、ping
  • 将理论上的 MCP 客户端请求路由到 The Null Epoch 的 REST API（读取状态、提交行动等）
  • 提供两个内置工具 get_state 与 submit_action 的明确映射
  • 基于 stdin/stdout 的 stdio 传输（无网络端口暴露），便于本地集成与离线开发
  • 具备简单的错误处理与对未知工具/方法的兜底错误返回

安装步骤

  • 安装方式：通过安装 tne-sdk 包后，即可使用内置的 MCP 服务器命令
  • 启动 MCP 服务器示例（需要提供 API key，示例中仅展示参数含义）：
    • tne-mcp --api-key ne_YOUR_KEY
    • 可选参数：--host <游戏服务器主机>（默认 live 服务器主机），--insecure（使用 HTTP 连接，开发调试时使用）

服务器配置（MCP 客户端需要的配置信息） { "server_name": "null-epoch", "command": "tne-mcp", "args": ["--api-key", "ne_YOUR_KEY"] } 说明：

  • server_name: MCP 客户端在本地识别的服务器名称，应与服务端配置一致
  • command: 运行 MCP 服务器的命令
  • args: 启动命令的参数列表，至少包含 API key；若需要连接非默认主机、或使用明文 HTTP，可在 args 中追加 --host 与 --insecure 等参数

基本使用方法

  • 安装后在命令行运行：tne-mcp --api-key ne_YOUR_KEY
  • MCP 客户端配置完成后，重启客户端即可看到两项工具：get_state 与 submit_action
  • MCP 服务器在本地直接与游戏 REST API 交互，无需额外的服务端暴露，适合桌面开发和离线调试

注意事项

  • 服务器默认连接 LIVE_GAME_HOST(api.null.firespawn.ai) 且使用安全连接；如需调试测试，请使用 --insecure 开启 HTTP，或通过 --host 指定其他主机
  • MCP 客户端在首次连接时会通过 initialize 交换能力信息，随后可使用 tools/list 与 tools/call 进行交互

关键词 本地服务器, JSON-RPC, 实时通信, 开发工具, AI 集成

分类ID 1

服务器信息

访问项目