云雀-mcp服务器

Name: 云雀-mcp服务器
Author: wizd

作者：wizd23 星标更新：2025-04-06

安装使用来源：spider==github.com

项目介绍

AiryPark MCP 专业翻译服务器

这是AiryPark项目的ModelContextProtocol (MCP)服务器模块，提供专业级别的高精度翻译服务接口。MCP是一种标准协议，允许智能助手与外部服务进行结构化交互，使大型AI模型如Claude可以直接调用复杂的翻译能力。

专业翻译的优势

三阶段翻译过程分析和规划、分段翻译、全文审查，确保专业领域文档的翻译质量。
领域术语识别自动识别专业文本领域，提取关键词，确保术语一致性。
质量评估系统提供全面的翻译质量评估，包括准确性、流畅性、术语使用和风格一致性。
多语言支持支持多种语言之间的翻译，包括中文、英文、日文、韩文、法文、德文等。
风格和格式保存根据文本类型自动调整翻译风格，保持原文的专业性和表达方式。

适用场景

技术文档翻译软件文档、API文档、技术规范等专业内容的翻译。
学术论文翻译确保学术术语的准确性并保持学术风格。
法律文件翻译确保法律术语的准确性和精确表达。
医学材料翻译专业医学术语的翻译及医学文献的本地化。
财务报告翻译准确翻译财务术语和复杂财务概念。

安装

确保已安装Node.js (v18+) 和 npm
安装依赖：

cd mcp-server
npm install

配置环境变量：

创建.env文件或设置以下环境变量：

# 翻译API配置
TRANSLATION_API_KEY=your_api_key
TRANSLATION_MODEL=your_model_name
TRANSLATION_BASE_URL=your_api_base_url

# 服务器配置
PORT=3031  # MCP服务器端口，可选，默认3031

使用说明

开发环境

启动开发服务器：

npm run dev

生产环境

构建并启动服务器：

npm run build
npm start

MCP工具接口

服务器提供以下MCP标准工具：

1. 翻译工具 (translate_text)

专业级别的文本翻译，自动适应不同领域和文学风格。

参数：

text需要翻译的源文本
target_language目标语言代码（例如'zh'、'en'、'ja'等）
source_language: （可选）源语言代码
high_quality: （可选）启用高精度翻译流程，默认为true

使用场景：

设置high_quality=true用于需要高精度的场景，如专业文档和学术论文
设置high_quality=false用于非正式内容或需要快速翻译的场景

2. 翻译质量评估工具 (evaluate_translation)

对翻译结果进行全面的质量评估，并提供详细的反馈。

参数：

original_text: 原始文本
translated_text翻译文本
detailed_feedback: （可选）提供详细反馈，默认为false

评估指标：

准确性：翻译是否准确传达了原始含义
流畅性：翻译是否符合目标语言的表达习惯
术语使用：专业术语翻译的准确性和一致性
风格一致性：翻译是否保持了原文的风格

资源接口

supported_languages支持的语言列表
- URI: languages://list

与AI助手集成

此服务器设计为无缝集成到支持MCP协议的AI助手中，使AI能够提供专业翻译服务：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

// 连接到MCP服务器
const transport = new SSEClientTransport("http://localhost:3031");
const client = new Client(
  { name: "assistant-client", version: "1.0.0" },
  { capabilities: { tools: {} } }
);
await client.connect(transport);

// 调用专业翻译工具
const result = await client.callTool({
  name: "translate_text",
  arguments: {
    text: "线粒体是细胞的动力工厂。",
    target_language: "zh",
    high_quality: true
  }
});

console.log(result.content[0].text);

Claude Chat和Cursor MCP客户端配置

在支持MCP协议的AI助手应用中，可以通过以下方法配置连接到AiryMark翻译服务器：

Cursor配置

在cursor设置或配置文件中添加以下MCP服务器配置：

{
  "mcpServers": {
    "airylark-translation": {
      "url": "https://airylark-mcp.vcorp.ai/sse"
    }
  }
}

Claude Chat配置

在Claude Chat中，可以按照以下步骤激活MCP服务器连接：

进入设置页面
找到“开发者设置”或“外部工具”选项
添加一个新的MCP服务器，填写名称和URL
填写服务器URL https://airylark-mcp.vcorp.ai/sse

配置完成后，AI助手可以轻松处理各种专业文档翻译需求，使用“translate_text”和“evaluate_translation”工具。

服务器配置和操作

AiryPark MCP服务器支持多种部署和操作模式。以下是常见的配置方法：

Docker部署

最简单的部署方法是使用官方发布的Docker镜像：

# 拉取官方镜像
docker pull wizdy/airylark-mcp-server

# 运行容器
docker run -p 30_31:3031 --env-file .env -d wizdy/airylark-mcp-server

Docker Compose部署

使用项目提供的docker-compose.yml文件，结合官方镜像，使得服务管理更加方便：

# docker-compose.yml 示例
services:
  mcp-server:
    image: wizdy/airylark-mcp-server
    ports:
      - "${MCP_PORT}:${MCP_PORT}"
    environment:
      - NODE_ENV=production
      - PORT=${MCP_PORT}
      - TRANSLATION_API_KEY=${TRANSLATION_API_KEY}
      - TRANSLATION_MODEL=${TRANSLATION_MODEL}
      - TRANSLATION_BASE_URL=${TRANSLATION_BASE_URL}
    restart: always

运行服务：

# 设置环境变量或创建.env文件
export MCP_PORT=3031
export TRANSLATION_API_KEY=your_api_key
export TRANSLATION_MODEL=your_model_name
export TRANSLATION_BASE_URL=your_api_base_url

# 启动服务
docker-compose up -d

服务器配置示例

也可以使用类似以下的方法来定义和启动MCP服务器：

{
  "mcpServers": {
    "airylark-translation": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRANSLATION_API_KEY",
        "-e",
        "TRANSLATION_MODEL",
        "-e",
        "TRANSLATION_BASE_URL",
        "wizdy/airylark-mcp-server"
      ],
      "env": {
        "TRANSLATION_API_KEY": "<YOUR_API_KEY>",
        "TRANSLATION_MODEL": "<YOUR_MODEL>",
        "TRANSLATION_BASE_URL": "<YOUR_API_URL>"
      }
    }
  }
}

这种配置方法适用于需要在应用程序内直接管理MCP服务器生命周期的场景。

许可证

本项目使用与AiryPark主项目相同的定制许可证，详情见LICENSE文档。