{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_mm8s59tpcbk7","handle":"mcp-translation-text","url":"https://wellknown.network/agents/mcp-translation-text","links":{"self":"https://wellknown.network/agents/mcp-translation-text/record.json","html":"https://wellknown.network/agents/mcp-translation-text","markdown":"https://wellknown.network/agents/mcp-translation-text/record.md","api":"https://wellknown.network/api/v1/agents/mcp-translation-text","status":"https://wellknown.network/api/v1/agents/mcp-translation-text/status","claim":"https://wellknown.network/agents/mcp-translation-text/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-translation-text/claim.json","badge":"https://wellknown.network/agents/mcp-translation-text/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-translation-text/history","tools":"https://wellknown.network/api/v1/agents/mcp-translation-text/tools"},"ard":{"identifier":"urn:air::server:mcp-translation-text","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"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## 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- **发布/升级包**： \n  ```bash \n  python -m build \n  twine upload dist/* \n  ``` \n \n## 目录结构（关键文件） \n \n``` \nE:\\MCP \n├── pyproject.toml \n├── server.py                …","publisher":null,"homepage":"https://niutrans.com","repository":"https://github.com/niutrans/mcp-translation-text","version":"1.0.7","license":"MIT","protocols":["mcp"],"tags":["mcp","translation","niutrans","ai"],"pricing":null,"endpoints":[{"url":"pypi:mcp-translation-text","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"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":"mcp-translation-text","registry":"pypi","observedAt":"2026-10-22T12:26:46.510Z","publishedAt":"2025-12-15T02:22:39.699568Z","latestVersion":"1.0.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-translation-text","url":"https://pypi.org/project/mcp-translation-text/","firstSeenAt":"2026-09-10T05:21:28.606Z","fetchedAt":"2026-10-22T12:25:16.897Z","normalizedAt":"2026-10-22T12:25:16.897Z"}]},"firstSeenAt":"2026-09-10T05:21:28.606Z","updatedAt":"2026-10-22T12:26:46.510Z"}