{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5xcqgq8yf9r9","handle":"iflow-mcp-niutrans-mcp-translation-text","url":"https://wellknown.network/agents/iflow-mcp-niutrans-mcp-translation-text","links":{"self":"https://wellknown.network/agents/iflow-mcp-niutrans-mcp-translation-text/record.json","html":"https://wellknown.network/agents/iflow-mcp-niutrans-mcp-translation-text","markdown":"https://wellknown.network/agents/iflow-mcp-niutrans-mcp-translation-text/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-niutrans-mcp-translation-text","status":"https://wellknown.network/api/v1/agents/iflow-mcp-niutrans-mcp-translation-text/status","claim":"https://wellknown.network/agents/iflow-mcp-niutrans-mcp-translation-text/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-niutrans-mcp-translation-text/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-niutrans-mcp-translation-text/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-niutrans-mcp-translation-text/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-niutrans-mcp-translation-text/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-niutrans-mcp-translation-text","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_niutrans_mcp-translation-text","summary":"MCP provider wrapping the Niutrans translation API","description":"# MCP 翻译服务\n\n基于小牛翻译（NiuTrans）API 的 MCP Provider，提供文字翻译工具和语种目录资源，方便在 Cursor/mcp-cli 等客户端中引用。\n\n## 快速开始\n\n### 使用 uv 安装并启动发布版\n\n```bash\nuv tool install mcp-translation-text\n```\n\n## 环境变量\n\n- `NIUTRANS_API_KEY`（必填）：小牛翻译开放平台提供的 API Key,可免费使用, 请登录后获取:https://niutrans.com/cloud/account_info/info\n\n## 计费说明\n\n本服务使用小牛翻译的文本翻译 API，计费规则如下：\n\n| 项目 | 说明 |\n|------|------|\n| 计费单位 | 2000 字符 = 1 积分 |\n| 免费额度 | 每天免费赠送 **100 积分** |\n| 每日可翻译 | 约 **20 万字符**（免费额度） |\n\n> 💡 **提示**：每日免费赠送的 100 积分足够日常使用，超出部分可在[小牛翻译开放平台](https://niutrans.com/price)充值购买。\n\n## MCP 客户端配置示例\n\n若通过 `uv tool install` 安装，可在 `mcp.json` 中写：\n\n```json\n{\n  \"mcpServers\": {\n    \"translation\": {\n      \"type\": \"stdio\",\n      \"command\": \"uv\",\n      \"args\": [\n        \"tool\",\n        \"run\",\n        \"mcp-translation-text\"\n      ],\n      \"env\": {\n        \"NIUTRANS_API_KEY\": \"${env.NIUTRANS_API_KEY}\"\n      }\n    }\n  }\n}\n```\n\n启动 Cursor 后执行 `ListTools` 即可看到 `translate_text`，同时支持 `ListResources` 读取 `language://catalog`。\n\n## 可用功能\n\n### 工具：`translate_text`\n\n- **参数**：\n  - `text`：待翻译内容。\n  - `source`：源语言代码或别名（会通过本地映射表规范化）。\n  - `target`：目标语言代码或别名。\n- **返回**：\n  ```json\n  {\n    \"source\": \"zh\",\n    \"target\": \"en\",\n    \"original_text\": \"你好\",\n    \"translated_text\": \"Hello\",\n    \"raw\": { ... 小牛原始响应 ... }\n  }\n  ```\n\n### 资源：`language://catalog`\n\n提供所有可用语种及别名，示例如下：\n\n```json\n{\n  \"total\": 455,\n  \"languages\": [\n    {\"code\": \"zh\", \"zh\": \"中文(简体)\", \"en\": \"Chinese (Simplified)\"},\n    {\"code\": \"en\", \"zh\": \"英语\", \"en\": \"English\"}\n    // ... 其余省略 ...\n  ],\n  \"aliases\": {\n    \"zhongwenjianti\": \"zh\",\n    \"english\": \"en\"\n    // ... 其余省略 ...\n  }\n}\n```\n\n推荐在客户端的 LLM 中先读取该资源，完成语种描述到代码的映射后，再调用 `translate_text`。\n\n## 调试与常见问题\n\n- **缺少 API Key**：启动时报 `缺少环境变量 NIUTRANS_API_KEY`，请确认已在 `.env` 或系统环境中设置。\n- **语种不支持**：`translate_text` 会校验语种代码/别名，若报错请检查是否使用了 `language://catalog` 中列出的值。\n- **路径或依赖问题**：脚本依赖 `uv`，请先安装 `pip install uv` 或参考 [uv 文档](https://github.com/astral-sh/uv)。\n- **命令名称**：通过 PyPI 安装后，可直接运行 `mcp-translation-text`；若 global PATH 中找不到，记得激活虚拟环境或使用 `python -m mcp_translation_text`。\n- **发布/升…","publisher":null,"homepage":"https://niutrans.com","repository":"https://github.com/niutrans/mcp-translation-text","version":"1.0.7","license":null,"protocols":["mcp"],"tags":["mcp","translation","niutrans","ai"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_niutrans_mcp-translation-text","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"content.translation","name":"Translation","confidence":1,"provenance":"declared"}],"categories":["content"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_niutrans_mcp-translation-text","registry":"pypi","observedAt":"2026-10-22T03:28:13.602Z","publishedAt":"2026-01-21T07:22:30.246577Z","latestVersion":"1.0.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_niutrans_mcp-translation-text","url":"https://pypi.org/project/iflow-mcp_niutrans_mcp-translation-text/","firstSeenAt":"2026-09-09T20:24:34.871Z","fetchedAt":"2026-10-22T03:26:59.737Z","normalizedAt":"2026-10-22T03:26:59.737Z"}]},"firstSeenAt":"2026-09-09T20:24:34.871Z","updatedAt":"2026-10-22T03:28:13.602Z"}