POEditor MCP 服务器

POEditor MCP Server 是一个用于与 POEditor API 交互的 Model Context Protocol (MCP) 服务器,提供管理 POEditor 项目、语言、术语和贡献者的工具。

  • by mark-hingston
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mark-hingston/po-editor-mcp-server

使用说明

POEditor MCP服务器

该项目提供了一个模型上下文协议(MCP)服务器,用于与 POEditor API.它将各种API端点公开为可由任何MCP兼容客户端使用的工具。

特性

  • 提供一套全面的工具来管理POEditor项目、语言、术语和贡献者。
  • 通过环境变量安全地处理POEditor API令牌。
  • 与官方合作建造 @modelcontextprotocol/sdk.
  • 配置为可执行命令行应用程序。
  • 使用Docker进行容器化,便于部署。

先决条件

入门指南

有两种方法可以运行此服务器:本地使用Node.js或Docker。

选项1:使用Node.js在本地运行

1.安装

克隆存储库并安装依赖项:

git clone <repository-url>
cd po-editor-mcp-server
npm install

2.配置

此服务器要求将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 文件。