Better i18n MCP 服务器套件

关键词

语言资源内容管理容错缓存CDN 回退AI 助手集成
  • 项目简介
    • 该仓库提供基于 Model Context Protocol 的服务器端实现，用于向 AI 代理/LLM 客户端暴露资源、工具和提示模板等能力。核心组件包含翻译资源的 MCP 服务（mcp）、以及内容管理的 MCP 服务（mcp-content），并实现了多传输通道（如 STDIO、HTTP、WebSocket/ SSE 等）的服务器端通信。
  • 主要功能点
    • MCP 核心服务器：注册和暴露工具、资源、语言、以及与客户端交互的能力描述；通过 JSON-RPC 进行请求/响应。
    • 资源与语言管理：通过 CDN 和本地回退机制，提供语言清单、翻译文本、以及缓存策略（内存、持久化存储、静态回退）。
    • 工具执行框架：采用统一的工具执行封装，支持项目域范围的输入校验、错误处理与结果封装，便于 LLM 调用外部功能。
    • 内容管理 MCP：覆盖内容模型、条目、字段等操作的工具集合，支持批量创建/更新/发布等能力。
    • 传输协议支持：提供 STDIO 与 HTTP 两种主要传输通道的实现，以及在 Cloud/Worker 场景下的远程传输适配。
    • 版本与健康检查：包括对服务器端工具、组件版本的自检与更新提示，以及健康评分机制的整合。
  • 安装和运行步骤
    • 克隆仓库并安装依赖。
    • 构建/编译 TypeScript 代码以生成可运行的 JavaScript 入口。
    • 启动两类 MCP 服务中的任意一个或同时启动：
      • 翻译资源与语言管理服务（核心 MCP，mcp）
      • 内容管理服务（MCP content，mcp-content）
    • 不同传输通道启动命令示例将放在服务器配置中，后续客户端按需连接。
  • 服务器配置（供 MCP 客户端启动连接所需的配置信息）
    • 对于翻译资源与语言管理的 MCP 服务（mcp），示例配置（JSON）如下： { "serverName": "better-i18n-mcp", "command": "node", "args": ["dist/index.js"], "workDir": "<项目根目录>/packages/mcp", "description": "翻译资源与语言管理的 MCP 服务器入口。请确保先构建生成 dist 目录。" }
    • 对于内容管理的 MCP 服务（mcp-content），示例配置（JSON）如下： { "serverName": "better-i18n-mcp-content", "command": "node", "args": ["dist/index.js"], "workDir": "<项目根目录>/packages/mcp-content", "description": "内容管理的 MCP 服务器入口。请确保先构建生成 dist 目录。" }
    • 配置说明要点
      • serverName：服务器在客户端侧的标识名称，便于区分不同的 MCP 服务实例。
      • command 与 args：启动服务器的命令及参数。由于源码为 TypeScript，生产环境请先编译成 JS，再给出 dist/ 入口路径；客户端可以按此入口启动服务器。
      • workDir：服务器工作目录，便于定位日志、缓存等资源。
      • 备注信息：可在 description 字段中给出构建与启动的注意事项，如需先执行构建、如需配置环境变量等。
  • 基本使用方法
    • 构建与部署
      • 安装依赖、编译源码，将 TypeScript 转译为可执行的 JavaScript。
    • 启动服务器
      • 进入对应服务的工作目录，使用配置中的命令启动，例如使用 Node 运行 dist/index.js。
    • 客户端连接
      • MCP 客户端需要以 JSON-RPC 形式向服务器发起请求，关于连接的具体请求参数与 RPC 调用细节，请参考各服务的工具定义与 API 文档。客户端一般需要知道服务器入口、命名、以及可调用的工具集合。
  • 重要注意
    • 仓库实现包含两类 MCP 服务：mcp（翻译资源/语言管理）与 mcp-content（内容管理工具）。如需对接真实的 AI 助手，需要相应的认证/鉴权配置（如 API Key、服务绑定等），并符合各自传输通道的约束。
    • 在生产环境中，确保正确的环境变量配置、网络访问、以及 CDN 的可用性与回退策略。

服务器信息

访问项目