MCP-Lingvanex-Translate Server

MCP Prototype – Máy Chủ Dịch Thuật

Dự án này triển khai một máy chủ MCP (Model Context Protocol) để dịch văn bản. Máy chủ hỗ trợ hai phương thức truyền tải:

• stdio – để tích hợp với Claude Desktop
• http (có thể truyền trực tuyến) – để kiểm thử và làm việc qua HTTP + SSE

---

⚙️ Yêu Cầu

• Node.js >= 18
• Yarn hoặc npm
• Đã cài đặt Claude Desktop (để tích hợp stdio)
• Tài khoản Lingvanex Translator để dịch văn bản

---

🔑 Thiết Lập Lingvanex Translator

Để sử dụng Lingvanex Translator, bạn cần có tài khoản Lingvanex.

1. Nếu chưa có, hãy đăng ký miễn phí
2. Chuyển đến tab Cloud API: Cloud API
3. Điền thông tin Địa chỉ thanh toán
4. Nhấp Tiếp tục thanh toán
   • Để dùng thử miễn phí, bạn không cần thêm thẻ thanh toán
5. Khóa API của bạn sẽ được tạo và hiển thị trong tab Cloud API: API key

Bây giờ bạn đã sẵn sàng bắt đầu sử dụng API dịch thuật. Dưới đây là video hướng dẫn tổng quan về quy trình (nếu có trên trang Lingvanex).

---

🚀 Cài Đặt & Biên Dịch

Sao chép kho lưu trữ

git clone https://github.com/lingvanex-mt/MCP-Lingvanex-Translate.git cd mcp-prototype

Cài đặt các gói phụ thuộc

yarn install

---

🔌 Chạy ở chế độ stdio (Claude Desktop)

Chế độ stdio được Claude Desktop sử dụng để kết nối với các máy chủ MCP cục bộ.

Đặt biến môi trường:

TRANSPORT=stdio

Khởi động máy chủ:

yarn build yarn start

Đầu ra mong đợi:

MCP stdio transport running
Translate MCP Server ready

---

🌐 Chạy ở chế độ HTTP (có thể truyền trực tuyến)

Chế độ http chạy một máy chủ HTTP cục bộ với phương thức truyền tải HTTP. Hữu ích cho việc kiểm thử trên trình duyệt hoặc với curl.

Đặt biến môi trường:

TRANSPORT=http HTTP_PORT=3000

Kiểm thử máy chủ:

curl http://127.0.0.1:3000/ping

Phản hồi mong đợi:

{ "status": "ok", "transport": "http" }

Sử dụng MCP Inspector để gỡ lỗi:

npx @modelcontextprotocol/inspector

Trong giao diện MCP Inspector, chọn Transport Type - Streamable HTTP; URL - http://localhost:3000/mcp. Nhấp Connect.

---

🖥️ Tích Hợp với Claude Desktop

Claude Desktop phát hiện các máy chủ MCP cục bộ qua tệp cấu hình:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Ví dụ cấu hình (Windows)

Mở (hoặc tạo) claude_desktop_config.json và thêm:

{ "mcpServers": { "translate": { "command": "node", "args": [ "C:\Users\đường\dẫn\đến\dự\án\dist\index.js" ] } } }

⚠️ Hãy đảm bảo cập nhật đường dẫn đến dist/index.js cục bộ của bạn sau khi biên dịch!

---

✅ Cách Xác Minh

1. Khởi chạy Claude Desktop.
2. Nhập một yêu cầu như:"Sử dụng công cụ MCP translatetext để dịch 'Hello world' sang tiếng Nga."
3. Nếu mọi thứ được cấu hình đúng, Claude sẽ gọi máy chủ MCP của bạn và trả về bản dịch.

---

📌 Công Cụ Có Sẵn

translate_text

Dịch văn bản từ ngôn ngữ này sang ngôn ngữ khác.

Tham số:

• text – văn bản cần dịch
• sourceLang – mã ngôn ngữ nguồn (ví dụ: "en")
• targetLang – mã ngôn ngữ đích (ví dụ: "ru")

Yêu cầu ví dụ:

{ "tool": "translate_text", "args": { "text": "Good morning", "sourceLang": "en", "targetLang": "fr" } }

Phản hồi ví dụ:

{ "content": [ { "type": "text", "text": "Bonjour" } ] }

---