MCP-Lingvanex-Translate

MCP Prototype – Máy chủ Dịch

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 dữ liệu Đị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: Khóa API

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

---

🚀 Cài đặt & Build

# Clone the repository
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 kiểm thử trình duyệt hoặc với curl.

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

TRANSPORT=http
HTTP_PORT=3000

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

yarn build
yarn start

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 Loại truyền tải - HTTP có thể truyền trực tuyến; URL - http://localhost:3000/mcp. Nhấp Kết nối.

---

🖥️ 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\\path\\to\\project\\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 build!

---

✅ 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 translate_text để 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ác 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" }
  ]
}

---