MCP Translation Server

满语-中文翻译和文本分析服务器

功能特性

✨ 核心功能：

• 满语 ↔ 中文双向翻译
• 形态学分析（词性、时态、人称等）
• RESTful API 接口
• 错误处理和验证

快速开始

1. 克隆仓库

git clone https://github.com/liliya0822/mcp-translation-server.git
cd mcp-translation-server

2. 创建虚拟环境

# Linux/Mac
python -m venv venv
source venv/bin/activate

# Windows
python -m venv venv
venv\Scripts\activate

3. 安装依赖

pip install -r requirements.txt

4. 配置项目

# 复制配置模板
cp config/config.example.json config/config.json

# 编辑配置文件（可选）
vim config/config.json

5. 运行服务器

python server.py

服务器将在 http://localhost:8000 启动

6. 运行演示

python demo/comprehensive_demo.py

API 文档

获取服务器信息

GET /

响应示例：

{
  "name": "MCP Translation Server",
  "version": "1.0.0",
  "endpoints": {
    "translate": "POST /api/v1/translate",
    "analyze": "POST /api/v1/analyze",
    "health": "GET /health"
  }
}

健康检查

GET /health

响应示例：

{
  "status": "healthy"
}

获取支持的语言

GET /api/v1/languages

响应示例：

{
  "supported_languages": ["manchu", "chinese"],
  "language_pairs": [
    {
      "source": "manchu",
      "target": "chinese"
    },
    {
      "source": "chinese",
      "target": "manchu"
    }
  ]
}

翻译文本

POST /api/v1/translate
Content-Type: application/json

{
  "text": "bi bithe arambi",
  "source_lang": "manchu",
  "target_lang": "chinese"
}

响应示例：

{
  "original_text": "bi bithe arambi",
  "translated_text": "我 书 来",
  "source_lang": "manchu",
  "target_lang": "chinese",
  "confidence": 0.85
}

文本分析（形态学）

POST /api/v1/analyze
Content-Type: application/json

{
  "text": "arambi",
  "type": "morphology"
}

响应示例：

{
  "text": "arambi",
  "analysis_type": "morphology",
  "result": {
    "lemma": "ara",
    "pos": "verb",
    "tense": "present",
    "person": "1st",
    "number": "singular",
    "mood": "indicative"
  }
}

获取支持的分析类型

GET /api/v1/analysis-types

响应示例：

{
  "analysis_types": [
    {
      "type": "morphology",
      "description": "形态学分析，包括词性、时态等信息"
    }
  ]
}

项目结构

mcp-translation-server/
├── server.py                    # 主服务器应用
├── demo/
│   └── comprehensive_demo.py    # 综合演示脚本
├── config/
│   └── config.example.json      # 配置模板
├── requirements.txt             # 项目依赖
└── README.md                    # 项目文档

支持的语言对

源语言	目标语言
manchu	chinese
chinese	manchu

支持的分析类型

类型	描述
morphology	形态学分析（词性、时态、人称等）

使用示例

Python 客户端

import requests

# 翻译示例
response = requests.post(
    "http://localhost:8000/api/v1/translate",
    json={
        "text": "bi bithe arambi",
        "source_lang": "manchu",
        "target_lang": "chinese"
    }
)
print(response.json())

# 分析示例
response = requests.post(
    "http://localhost:8000/api/v1/analyze",
    json={
        "text": "arambi",
        "type": "morphology"
    }
)
print(response.json())

curl

# 翻译请求
curl -X POST http://localhost:8000/api/v1/translate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "bi bithe arambi",
    "source_lang": "manchu",
    "target_lang": "chinese"
  }'

# 分析请求
curl -X POST http://localhost:8000/api/v1/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "text": "arambi",
    "type": "morphology"
  }'

交互式 API 文档

启动服务器后，访问：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

故障排除

无法连接到服务器

# 检查服务器是否运行
python server.py

# 检查端口是否被占用
# Linux/Mac: lsof -i :8000
# Windows: netstat -ano | findstr :8000

导入错误

# 确保虚拟环境已激活
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate     # Windows

# 重新安装依赖
pip install -r requirements.txt

配置文件错误

# 复制示例配置
cp config/config.example.json config/config.json

开发和贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License

联系方式

• 项目主页: https://github.com/liliya0822/mcp-translation-server
• 问题报告: https://github.com/liliya0822/mcp-translation-server/issues