Levelang.app MCP服务器
   
一 主控程序 暴露的服务器 Levelang.app 将API翻译成人工智能助手。与总是产生母语者复杂性的标准翻译不同，levelang.app将翻译限制在学习者的熟练程度范围内。
______________________________________________________________________
特性
- 水平感知翻译 --初级、中级、高级或流利地翻译文本，每个级别都有语法限制
- 多语言支持 --法语、德语、意大利语、普通话、粤语，如适用，可音译
- 情绪控制 --随意、礼貌、正式的翻译风格
- 语言发现 --从后端动态查询可用的语言、级别和情绪
- MCP资源 —
levelang://languages和levelang://languages/{code}用于将语言配置拉入上下文 - 无状态包装器 --没有数据库，没有共享状态；将MCP工具调用转换为后端HTTP请求
快速开始
你需要两件事： MCP服务器URL 和a API密钥。不需要本地设置。
光标
增添 .cursor/mcp.json:
{
"mcpServers": {
"levelang": {
"url": "https://your-mcp-server-url/mcp",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
}克劳德桌面版
增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"levelang": {
"url": "https://your-mcp-server-url/mcp",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
}重新启动克劳德桌面。聊天输入中的锤子图标表示MCP工具可用。
示例用法
连接后，询问您的AI助手以下问题：
将“我想点一杯咖啡，请”翻译成初级法语。
Levelang支持哪些语言？
比较一下“我担心新规定可能会阻止我们按时完成”在初级和高级德语中的翻译。
服务器配置
以下设置适用于 运行MCP服务器 （本地开发或自托管）。通过URL连接的最终用户不需要这些。
所有配置都是通过环境变量进行的。当通过stdio在本地运行时，这些会进入 env MCP客户端配置块。
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
LEVELANG_API_BASE_URL | 没有 | http://localhost:8000/api/v1 | levelang后端URL |
LEVELANG_API_KEY | 取决于 | -- | 服务密钥(sk_xxx)用于后端身份验证 |
MCP_TRANSPORT | 没有 | stdio | 运输： stdio 或 streamable-http |
MCP_PORT | 没有 | 8463 | 使用HTTP传输时的端口 |
MCP_API_KEYS | 没有 | - | 用于HTTP身份验证的逗号分隔的有效API密钥 |
LEVELANG_API_KEY 连接到远程后端（暂存/生产）时需要。如果后端已禁用身份验证，则可以省略本地开发。
MCP_API_KEYS 控制HTTP传输的客户端身份验证。设置后，客户端必须发送 Authorization: Bearer 使用此列表中的密钥。当为空或未设置时，身份验证将被禁用（开放访问）。这对stdio传输没有影响。
本地stdio连接
git clone https://github.com/beverage/levelang-mcp.git
cd levelang-mcp
uv sync{
"mcpServers": {
"levelang": {
"command": "uv",
"args": [
"run",
"--directory", "/absolute/path/to/levelang-mcp",
"python", "-m", "levelang_mcp"
],
"env": {
"LEVELANG_API_BASE_URL": "http://localhost:8000/api/v1"
}
}
}
}发展
设置
uv sync
git config core.hooksPath .githooks这启用了预提交（自动修复lint+format）和预推（lint+format检查+测试）挂钩。
运行测试
uv run pytest tests/ -vMCP检查员
这 MCP检查员 提供用于浏览和调用工具和资源的web UI：
npx @modelcontextprotocol/inspector uv run --directory /path/to/levelang-mcp python -m levelang_mcp项目结构
src/levelang_mcp/
├── __main__.py # Entrypoint (python -m levelang_mcp)
├── server.py # MCP tools and resources
├── auth.py # API-key auth middleware for HTTP transport
├── client.py # Async HTTP client for the Levelang API
├── config.py # Environment variable loading
└── formatting.py # API response → human-readable text
tests/
├── test_auth.py # Auth middleware and config tests
├── test_client.py # HTTP client tests (mocked)
├── test_formatting.py
└── test_tools.py # Tool integration tests (mocked)建筑
MCP Client levelang-mcp Levelang Backend
(Claude, Cursor, ◄── MCP/stdio ──► (this) ─── HTTP ──► (FastAPI)
Claude Code) POST /translate
GET /languages/details
GET /languages/{code}MCP服务器是一个无状态包装器。它将MCP工具调用转换为对Levelang后端的HTTP请求，并将响应格式化为LLM的人类可读文本。它不与后端共享代码、数据库连接或部署。
许可证
麻省理工学院