POEditor MCP服务器
该项目提供了一个模型上下文协议(MCP)服务器,用于与 POEditor API.它将各种API端点公开为可由任何MCP兼容客户端使用的工具。
特性
- 提供一套全面的工具来管理POEditor项目、语言、术语和贡献者。
- 通过环境变量安全地处理POEditor API令牌。
- 与官方合作建造
@modelcontextprotocol/sdk. - 配置为可执行命令行应用程序。
- 使用Docker进行容器化,便于部署。
先决条件
入门指南
有两种方法可以运行此服务器:本地使用Node.js或Docker。
选项1:使用Node.js在本地运行
1.安装
克隆存储库并安装依赖项:
git clone
cd po-editor-mcp-server
npm install2.配置
此服务器要求将POEditor API令牌设置为环境变量。
Linux/macOS:
export POEDITOR_API_TOKEN="your_api_token_here"Windows(命令提示符):
set POEDITOR_API_TOKEN="your_api_token_here"Windows(PowerShell):
$env:POEDITOR_API_TOKEN="your_api_token_here"3.建设与运营
首先构建服务器,然后运行它:
npm run build
npm run start服务器将启动并监听标准输入/输出上的MCP请求。
选项2:使用Docker运行
1.构建Docker镜像
从项目的根目录开始,构建Docker镜像:
docker build -t po-editor-mcp-server .2.运行Docker容器
运行容器,将POEditor API令牌作为环境变量传递:
docker run --rm -i -e POEDITOR_API_TOKEN="your_api_token_here" po-editor-mcp-server这 -i 旗帜很重要,因为它保持 stdin 打开,这是MCP服务器接收请求所必需的。
可用工具
服务器将POEditor API端点公开为工具。以下是可用工具及其主要功能的列表:
项目
projectsList:列出您的所有项目。projectsView:获取特定项目的详细信息。projectsAdd:创建新项目。projectsUpdate:更新现有项目的设置。projectsDelete:删除项目。projectsExport:将项目翻译导出到文件并提供下载链接。projectsSync:同步项目条款。
语言
languagesAvailable:列出项目的可用语言。languagesList:列出项目中的语言。languagesAdd:将语言添加到项目中。languagesUpdate:更新特定语言的翻译。languagesDelete:从项目中删除语言。
条款
termsList:列出项目术语。termsAdd:向项目添加新术语。termsUpdate:更新现有条款。termsDelete:从项目中删除术语。termsAddComment:为术语添加注释。
翻译
translationsAdd:添加新的翻译。translationsUpdate:更新现有翻译。translationsDelete:删除翻译。
贡献者
contributorsList:列出一个项目或所有项目的贡献者。contributorsAdd:向项目添加贡献者。contributorsRemove:从项目中删除贡献者。
有关每个工具参数的详细信息,您可以检查 inputSchema 在 src/tools.ts 文件。
