Intento Translation MCP Server

Intento 翻译 MCP 服务

这是一个使用 Intento API 提供翻译功能的 MCP 服务。

设置

1. 安装所需依赖：

pip install -r requirements.txt

2. 设置 Intento API 凭据

有两种方式：

2.a. 为 MCP 服务设置 Intento API 凭据（所有 MCP 客户端都将使用相同的凭据）

为 MCP 服务设置 Intento API 凭据：

• 在项目根目录中创建 .env 文件
• 添加 Intento API 密钥：

INTENTO_API_KEY=your_api_key_here

2.b. 为特定的 MCP 集成设置 Intento API 凭据，例如 Claude Desktop（不同的 MCP 客户端可以使用不同的凭据）

为特定的 MCP 集成设置 Intento API 凭据：

• 使用 MCP 配置 JSON 文件的 "env" 部分指定 "INTENTO_API_KEY" 变量。请参阅 Claude Desktop 集成部分中的示例

用法

1. 启动服务：

python server.py

2. 服务提供以下工具和资源：

translate

在不同语言之间翻译文本。接受语言名称和 ISO 代码。

参数：

• text（必填）：要翻译的文本
• target_language（必填）：目标语言（例如，“Spanish”或“es”）
• source_language（可选）：源语言（默认为空字符串，表示自动检测）

示例：

# Translate with automatic language detection
result = await translate("Hello world", target_language="Spanish")

# Translate with specific source language
result = await translate("Hello world", target_language="Spanish", source_language="English")

language-codes（资源）

资源 URL：mcp://intento-translate/language-codes

提供 Intento API 支持的语言名称及其 ISO 代码的映射。

此资源允许 Agent：

• 发现可用语言
• 查询语言名称对应的正确 ISO 代码
• 确保与 Intento API 兼容

使用该资源的示例：

# Get the language codes resource
language_codes = await get_resource("mcp://intento-translate/language-codes")

# Look up a language code
spanish_code = language_codes["codes"]["spanish"]  # Returns "es"

# Use the code in a translation
result = await translate("Hello world", target_language=spanish_code)

语言支持

服务会从 Intento API 动态获取语言代码，并将其作为资源提供。这种方式有几个优点：

1. 动态更新：语言支持始终与 Intento API 保持同步
2. Agent 自主性：Agent 可以自行发现并使用正确的语言代码
3. 灵活性：服务可以处理语言名称和 ISO 代码

自动语言检测

当 source_language 参数为空（默认值）时，服务将：

• 在 API 请求中省略源语言字段
• 让 Intento 自动检测源语言
• 将请求记录为使用“自动检测”，以便清楚了解情况

如果 API 请求失败，服务会回退到一组精简的常用语言代码。

错误处理

服务包含全面的错误处理和日志记录：

• 所有操作都会记录到 logs/intento-translate.log
• API 错误会被捕获，并以清晰的消息返回
• 无效语言代码会得到妥善处理

Claude Desktop 集成

要将此 MCP 服务与 Claude Desktop 配合使用：

1. 在 Claude Desktop 配置目录中创建 claude-mcp-config.json 文件：

   • Windows：%APPDATA%\Claude\claude-mcp-config.json
   • macOS：~/Library/Application Support/Claude/claude-mcp-config.json
   • Linux：~/.config/Claude/claude-mcp-config.json

2. 添加以下配置（根据你的安装情况调整路径）：

{
    "mcpServers": {
        "intento-translate": {
            "command": "python",
            "args": ["/path/to/your/mcp-intento-translate/server.py"],
            "cwd": "/path/to/your/mcp-intento-translate",
            "env": {
                "INTENTO_API_KEY": "<YOUR_API_KEY>" 
            }
        }
    }
}

仅当你想为此集成使用专用凭据，而不使用 MCP 服务专属凭据时，才需要 "env" 部分中的 "INTENTO_API_KEY"。

3. 重启 Claude Desktop 以加载新配置。

此服务现在可供 Claude Desktop 使用，并可通过 MCP 协议提供翻译功能和语言代码信息。