Devnagri Translation MCP Server

@devnagriai/devnagriai-translate-mcp

基于 JavaScript 的模型上下文协议（MCP）服务，通过 Devnagri AI API 提供翻译、语言检测和支持语言列表功能，重点支持印度语系语言。

功能

• 文本翻译：支持 35 种以上语言（包括所有主要印度语系语言）
• 语言检测：检测任意输入文本的语言
• 支持语言列表
• MCP 协议：可直接集成 AI 工具
• 完善的错误处理和验证
• 全面的测试套件

目录

• 功能
• 快速开始
• 获取 API 密钥
• 安装
  • NPX（推荐）
  • 手动安装
• 使用方法
  • 直接集成
  • 运行服务
• MCP 工具
  • 工具：translate
  • 工具：detect_language
  • 工具：list_supported_languages
• 配置
• 测试
• 贡献
• 支持
• 安全
• 许可证

快速开始

npx @devnagriai/devnagriai-translate-mcp API_KEY="your_devnagri_api_key"

获取 API 密钥

要使用 Devnagri Translation API，您需要 API 密钥。请按以下步骤操作：

1. 注册

   • 前往 Devnagri Dashboard 并注册免费账户。

2. 进入 API Hub

   • 登录后，从侧边栏菜单进入 API Hub 部分。

3. 选择 Translation API

   • 点击 Get API Key。
   • 点击 Create。
   • 为 API 密钥输入名称。
   • 点击 Save。

4. 复制 API 密钥

   • 复制生成的 API 密钥。请妥善保管，不要公开分享。

安装

NPX（推荐）

使用此 MCP 服务最简单的方式是通过 npx 运行，无需安装：

npx @devnagriai/devnagriai-translate-mcp API_KEY="your_devnagri_api_key"

这非常适合与 Claude、GPT、Windsurf 和 Cursor 等 AI 工具集成。

手动安装

如果您希望在本地安装服务：

1. 克隆代码仓库：

git clone https://github.com/DevnagriAI/devnagriai-translate-mcp.git
cd devnagriai-translate-mcp

2. 安装依赖项：

npm install

3. 设置环境变量：

在根目录中创建 .env 文件，并添加以下内容：

DEVNAGRI_API_KEY=your_devnagri_api_key

使用方法

直接集成

如需本地/私有使用或开发，请将服务添加到 MCP 配置中：

{
  "mcpServers": {
    "devnagri-translation": {
      "command": "npx",
      "args": [
        "@devnagriai/devnagriai-translate-mcp",
        "API_KEY=\"your_devnagri_api_key\""
      ]
    }
  }
}

运行服务

启动服务：

npm start

如需在开发模式下自动重新加载：

npm run dev

此 MCP 服务可与任何 MCP 客户端搭配使用。例如，使用 MCP CLI 客户端：

mcp-client --transport stdio -- node src/index.js

与 AI 工具集成

Windsurf

在 ~/.codeium/windsurf/mcp_config.json 中：

{
  "devnagri-translation": {
    "command": "npx",
    "args": [
      "@devnagriai/devnagriai-translate-mcp",
      "API_KEY=\"your_devnagri_api_key\""
    ]
  }
}

Cursor

在 Cursor 设置中：

{
  "tools": {
    "devnagri-translation": {
      "command": "npx",
      "args": [
        "@devnagriai/devnagriai-translate-mcp",
        "API_KEY=\"your_devnagri_api_key\""
      ],
      "transport": "stdio"
    }
  }
}

Claude

在 Claude Desktop App 中：

1. 前往 Settings > Extensions
2. 点击 "Add Custom Extension"
3. 选择 "Add from local server"
4. 输入以下详细信息：
   • 名称：Devnagri Translation Service
   • 命令：npx @devnagriai/devnagriai-translate-mcp API_KEY="your_devnagri_api_key"
   • 传输方式：stdio

或者使用以下配置：

{
  "devnagri-translation": {
    "command": "npx",
    "args": [
      "@devnagriai/devnagriai-translate-mcp",
      "API_KEY=\"your_devnagri_api_key\""
    ],
    "transport": "stdio"
  }
}

MCP 工具

此 MCP 服务提供以下工具：

工具名称	描述
translate	在支持的语言之间翻译文本
detect_language	检测给定文本的语言
list_supported_languages	列出所有可用语言

示例工具配置请参阅 examples/mcp_config_example.json。

工具：translate

将文本从源语言翻译成目标语言。

参数：

• source_text（字符串，必填）：要翻译的文本
• source_language（字符串，必填）：源语言代码（例如，"en"）
• target_language（字符串，必填）：目标语言代码（例如，"hi"）
• translation_type（字符串，可选）：所需的翻译类型（"literal" 或 "base"，默认为 "literal"）

返回：

{
  "translated_text": "नमस्ते, आप कैसे हैं?",
  "source_language": "en",
  "target_language": "hi",
  "translation_type": "literal"
}

工具：detect_language

检测所提供文本的语言。

参数：

• text（字符串，必填）：要检测语言的文本

返回：

{
  "detected_language": "en",
  "confidence_score": 0.98,
  "supported": true
}

工具：list_supported_languages

返回所有支持翻译的语言列表。

参数：

• 无

返回：

[
  {
    "name": "English",
    "native_name": "English",
    "code": "en"
  },
  {
    "name": "Hindi",
    "native_name": "हिन्दी",
    "code": "hi"
  },
  // ... more languages
]

配置

• API 密钥：必填。通过环境变量或命令行参数传递：API_KEY="your_devnagri_api_key"
• 端口：默认为 8080（可通过 MCP 协议参数配置）
• .env 支持：可在 .env 文件中放置 API 密钥，用于本地开发。

测试

使用以下命令运行测试套件：

npm test

测试覆盖所有 MCP 工具和 API 客户端逻辑的单元测试与集成测试。

贡献

1. Fork 此仓库
2. 创建功能分支
3. 提交拉取请求，说明所做的更改

支持

• 如有 API 问题，请联系 Devnagri 支持
• 如有 MCP 服务问题，请在此仓库中提交 GitHub issue

安全

• 切勿公开分享 API 密钥
• 定期通过 Devnagri 控制面板轮换 API 密钥

许可证

MIT