다국어 - 번역을 위한 모델 컨텍스트 프로토콜
Polyglot은 번역 서비스에 중점을 둔 모델 컨텍스트 프로토콜(MCP)의 오픈 소스 구현입니다. Claude Sonnet 3.5를 사용하여 여러 언어에 대한 번역 요청을 처리하는 표준화된 방식을 제공합니다.
지원 언어
- 아랍어(ar)
- 중국어(zh)
- 영어(en)
- 프랑스어(fr)
- 러시아어(ru)
- 스페인어(es)
특징
- 표준화된 번역 요청 형식
- 다양한 도메인 지원(법률, 의료, 일반)
- 공식 수준 통제(공식/비공식)
- Claude Sonnet 3.5 통합
- MCP 프로토콜 서버(FastMCP를 통해)
- API 키 인증
설치
uv 사용 (추천)
지엑스피1
pip 사용하기
# Install the package and its dependencies
pip install .
# For development, install with dev dependencies
pip install ".[dev]"
구성
- 프로젝트 루트에
.env 파일을 만듭니다.
ANTHROPIC_API_KEY=your_api_key_here
- API 키를 안전하게 보관하고 버전 제어에 커밋하지 마세요.
MCP 서버 실행
Polyglot MCP 서버는 FastMCP를 사용하여 MCP 프로토콜(SSE 전송)을 통해 번역 도구와 리소스를 제공합니다.
서버를 시작하려면:
python -m polyglot.server
기본적으로 서버는 SSE 전송을 사용하여 포트 8001에서 실행됩니다.
MCP 서버 테스트
MCP Inspector 사용(권장)
- MCP 검사기 설치:
npx @modelcontextprotocol/inspector
- Inspector UI를 엽니다(터미널에 로컬 주소가 표시됩니다).
- Inspector UI에서 다음을 설정합니다.
- 운송 유형: SSE
- URL:
http://localhost:8001/sse - (선택 사항) 필요한 경우 검사기 프록시 주소를 설정합니다.
- 이제 Inspector UI를 통해 번역 도구 및 리소스와 상호 작용할 수 있습니다.
Python MCP 클라이언트 사용
MCP Python SDK를 사용하여 프로그래밍 방식으로 서버와 상호 작용할 수도 있습니다.
from mcp.client.sse import sse_client
import asyncio
async def main():
async with sse_client(url="http://localhost:8001/sse") as (read, write):
# Example: call the translate tool
request = {
"tool": "translate",
"args": {
"request": {
"version": "1.0",
"type": "translation_request",
"metadata": {
"source_language": "fr",
"target_language": "en",
"domain": "legal",
"formality": "formal",
"api_key": "your_api_key_here" # Required for authentication
},
"data": {"text": "Le contrat a été signé hier à Genève."}
}
}
}
await write(request)
response = await read()
print(response)
asyncio.run(main())
프로토콜 사양
번역 요청은 다음 JSON 구조를 따릅니다.
{
"version": "1.0",
"type": "translation_request",
"metadata": {
"source_language": "fr",
"target_language": "en",
"domain": "legal",
"formality": "formal",
"api_key": "your_api_key_here" // Required for authentication
},
"data": {
"text": "Le contrat a été signé hier à Genève."
}
}
개발
개발 환경을 설정하려면:
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create and activate a virtual environment
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows
# Install development dependencies
uv pip install ".[dev]"
특허
MIT 라이센스