项目简介
POEditor MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在将大型语言模型 (LLM) 与 POEditor 翻译管理平台的功能集成。它允许LLM通过一系列定义的工具,直接操作POEditor中的术语、翻译和项目语言,从而实现智能化的翻译内容管理。
主要功能点
该服务器通过提供以下工具,使得LLM能够与POEditor进行交互:
- 添加带翻译的术语: 一次性创建新术语并为其添加翻译。
- 添加翻译: 为现有术语添加新翻译(不覆盖)。
- 更新翻译: 更改或覆盖现有术语的翻译。
- 列出术语: 查询项目中所有术语的列表,可选择包含特定语言的翻译。
- 列出项目语言: 查看项目中已启用的所有语言。
- 列出可用语言: 获取POEditor平台支持的所有语言列表。
- 添加语言: 向项目中添加新的语言。
安装步骤
- 克隆仓库:
git clone https://github.com/ryan-shaw/poeditor-mcp.git cd poeditor-mcp - 安装依赖:
npm install - 构建项目:
完成以上步骤后,服务器代码即可运行。npm run build
服务器配置
MCP 服务器通常需要与MCP客户端(如Claude Desktop)配合使用。您需要在MCP客户端的设置中,添加此POEditor MCP服务器的配置。以下是配置的关键信息和说明:
在您的MCP客户端的配置中,添加类似以下的JSON结构:
{ "mcpServers": { "poeditor": { "command": "npx", "args": ["tsx", "/path/to/poeditor-mcp/src/server.js"], "env": { "POEDITOR_API_TOKEN": "your_api_token_here", "POEDITOR_PROJECT_ID": "your_project_id" } } } }
- '"poeditor"': 这是您为该MCP服务器定义的名称,客户端将使用此名称来识别和调用它。
- '"command": "npx"': 启动服务器的命令。
- '"args": ["tsx", "/path/to/poeditor-mcp/src/server.js"]': 启动服务器时传递给 'command' 的参数列表。您需要将 '/path/to/poeditor-mcp/src/server.js' 替换为 'src/server.js' 文件在您本地系统中的绝对路径。
- '"env"': 服务器运行所需的环境变量。
- '"POEDITOR_API_TOKEN": "your_api_token_here"' (必填): 您的POEditor API令牌。您可以从POEditor账户的API访问页面获取。
- '"POEDITOR_PROJECT_ID": "your_project_id"' (可选): 默认的项目ID。如果设置,工具调用时可以省略项目ID;如果未设置,则每个工具调用都必须明确提供 'project_id'。
基本使用方法
配置完成后,您的MCP客户端(LLM)将能够识别并调用POEditor MCP服务器提供的工具。LLM可以通过发送JSON-RPC请求,调用例如 'add_terms_with_translations' 或 'list_terms' 等工具,从而实现对POEditor中翻译内容的自动化管理。LLM会根据其自身的理解和您提供的提示,选择合适的工具并传递所需的参数来执行操作。
信息
分类
AI与计算