Texterify MCP

文本验证mcp

A. 模型上下文协议（MCP） 允许LLM代理完全访问的服务器 文本验证 翻译管理API。无需离开编辑器，即可搜索、创建、更新和删除翻译键及其翻译。

为什么

在开发过程中管理翻译意味着在代码编辑器和Texterify web UI之间不断切换上下文。这个MCP服务器消除了这种摩擦——你的AI编码助手可以查找密钥、添加翻译、查找未翻译的字符串，并直接通过自然语言管理语言。

快速开始

最快的开始方式是通过 npx:

npx texterify-mcp

或全局安装：

npm install -g texterify-mcp

服务器需要以下环境变量：

您可以在Texterify帐户设置中找到您的API凭据。

注意 TEXTERIFY_PROJECT_ID: 虽然为了方便起见，可以将其设置为环境变量，但每个项目范围的工具也接受一个可选的 project_id 参数。分辨率顺序为：刀具参数→ 环境变量→ 错误。您可以在项目的 texterify.json 文件或使用 list_projects 工具。

客户端配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "texterify": {
      "command": "npx",
      "args": ["-y", "texterify-mcp"],
      "env": {
        "TEXTERIFY_AUTH_EMAIL": "you@example.com",
        "TEXTERIFY_AUTH_SECRET": "your-api-secret",
        "TEXTERIFY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %AppData%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

克劳德代码

claude mcp add --transport stdio \
  --env TEXTERIFY_AUTH_EMAIL=you@example.com \
  --env TEXTERIFY_AUTH_SECRET=your-api-secret \
  --env TEXTERIFY_PROJECT_ID=your-project-uuid \
  texterify -- npx -y texterify-mcp

注： 所有旗帜(--transport, --env)一定要来 之前 服务器名称。这 -- 将服务器名称与命令分开。 TEXTERIFY_PROJECT_ID 是可选的，可以为每个工具提供。

OpenCode

添加到您的 opencode.json （或 opencode.jsonc):

{
  "mcp": {
    "texterify": {
      "type": "local",
      "command": ["npx", "-y", "texterify-mcp"],
      "environment": {
        "TEXTERIFY_AUTH_EMAIL": "you@example.com",
        "TEXTERIFY_AUTH_SECRET": "your-api-secret",
        "TEXTERIFY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

TEXTERIFY_PROJECT_ID 是可选的，可以为每个工具提供。

VS代码/副本

增添 .vscode/mcp.json 在您的工作区中（或通过以下方式添加到您的用户配置文件中 MCP：添加服务器 在命令选项板中）：

{
  "servers": {
    "texterify": {
      "command": "npx",
      "args": ["-y", "texterify-mcp"],
      "env": {
        "TEXTERIFY_AUTH_EMAIL": "you@example.com",
        "TEXTERIFY_AUTH_SECRET": "your-api-secret",
        "TEXTERIFY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

TEXTERIFY_PROJECT_ID 是可选的，可以为每个工具提供。

光标

增添 .cursor/mcp.json 在项目根目录中（特定于项目）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "texterify": {
      "command": "npx",
      "args": ["-y", "texterify-mcp"],
      "env": {
        "TEXTERIFY_AUTH_EMAIL": "you@example.com",
        "TEXTERIFY_AUTH_SECRET": "your-api-secret",
        "TEXTERIFY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

TEXTERIFY_PROJECT_ID 是可选的，可以为每个工具提供。

可用工具

list_keys

搜索并列出带分页的翻译键。支持按名称和未翻译状态进行筛选。

get_key

检索单个翻译密钥及其所有翻译。

create_key

创建新的翻译密钥。

update_key

更新现有密钥的属性。仅更改提供的字段。

delete_keys

删除一个或多个翻译键。

set_translation

为特定密钥和语言创建或更新翻译（upstart）。

list_languages

列出项目中配置的语言及其翻译进度。

list_projects

列出经过身份验证的用户可访问的所有Texterify项目。可用于查找项目ID。

示例提示

配置后，您可以向AI助手询问以下问题：

• “列出我项目中所有未翻译的键”
• “创建一个名为 checkout.success_message 描述为“付款后显示”
• “此项目中配置了哪些语言？”
• “将键X的德语翻译设置为‘Willkommen’”
• “查找与'error'匹配的所有键”
• “删除我刚才创建的密钥”

发展

需要Node.js 18+和pnpm。

# Install dependencies
pnpm install

# Run the server
pnpm start

# Run in watch mode
pnpm dev

# Type-check
pnpm exec tsc --noEmit

# Run tests
pnpm test

运作原理

服务器使用 stdio传输 --它使用MCP JSON-RPC协议通过stdin/stdout进行通信。所有日志记录都会进入stderr，以保持协议通道的干净。

MCP Client (LLM Agent)
    |  stdio (JSON-RPC)
    v
Tool Handlers (Zod-validated inputs)
    |
    v
API Client (native fetch)
    |
    v
Texterify REST API

• 无构建步骤 --TypeScript直接通过以下方式执行 tsx
• 本土的 fetch --零HTTP库依赖（Node.js 18+）
• Zod v4 用于输入验证和自动生成JSON模式的模式
• 结构化错误处理，明确显示身份验证失败、资源丢失和验证错误的消息

许可证

国际学生委员会