MCP-Lingvanex-Translate Server

ต้นแบบ MCP – เซิร์ฟเวอร์แปลภาษา

โปรเจกต์นี้ใช้สร้าง เซิร์ฟเวอร์ MCP (Model Context Protocol) สำหรับการแปลข้อความ โดยเซิร์ฟเวอร์รองรับการเชื่อมต่อสองรูปแบบ:

• stdio – สำหรับการผสานรวมกับ Claude Desktop
• http (streamable) – สำหรับการทดสอบและทำงานผ่าน HTTP + SSE

---

⚙️ ข้อกำหนด

• Node.js >= 18
• Yarn หรือ npm
• ติดตั้ง Claude Desktop แล้ว (สำหรับการผสานรวมแบบ stdio)
• บัญชี Lingvanex Translator สำหรับการแปลข้อความ

---

🔑 การตั้งค่า Lingvanex Translator

ในการใช้ Lingvanex Translator คุณจะต้องมีบัญชี Lingvanex

1. หากยังไม่มี สมัครใช้งานฟรี
2. ไปที่แท็บ Cloud API: Cloud API
3. กรอกข้อมูล Billing Address
4. คลิก Continue to payment
   • หากต้องการทดลองใช้ฟรี ไม่จำเป็น ต้องเพิ่มบัตรชำระเงิน
5. API key ของคุณจะถูกสร้างและแสดงในแท็บ Cloud API: API key

ตอนนี้คุณพร้อมเริ่มใช้ API แปลภาษาแล้ว ด้านล่างเป็นวิดีโอสอนขั้นตอนโดยรวม (หากมีในเว็บไซต์ Lingvanex)

---

🚀 การติดตั้งและการสร้าง

โคลนที่เก็บโค้ด

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

ติดตั้งแพ็กเกจที่จำเป็น

yarn install

---

🔌 รันในโหมด stdio (Claude Desktop)

โหมด stdio ถูกใช้โดย Claude Desktop เพื่อเชื่อมต่อกับเซิร์ฟเวอร์ MCP ภายในเครื่อง

ตั้งค่าตัวแปรสภาพแวดล้อม:

TRANSPORT=stdio

เริ่มเซิร์ฟเวอร์:

yarn build yarn start

ผลลัพธ์ที่คาดหวัง:

MCP stdio transport running
Translate MCP Server ready

---

🌐 รันในโหมด HTTP (streamable)

โหมด http จะรันเซิร์ฟเวอร์ HTTP ภายในเครื่องด้วยการขนส่งแบบ HTTP มีประโยชน์สำหรับการทดสอบผ่านเบราว์เซอร์หรือใช้กับ curl

ตั้งค่าตัวแปรสภาพแวดล้อม:

TRANSPORT=http HTTP_PORT=3000

ทดสอบเซิร์ฟเวอร์:

curl http://127.0.0.1:3000/ping

การตอบกลับที่คาดหวัง:

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

ใช้ MCP Inspector สำหรับการดีบัก:

npx @modelcontextprotocol/inspector

ใน UI ของ MCP Inspector เลือก Transport Type - Streamable HTTP; URL - http://localhost:3000/mcp. คลิก Connect

---

🖥️ การผสานรวมกับ Claude Desktop

Claude Desktop ค้นพบเซิร์ฟเวอร์ MCP ภายในเครื่องผ่านไฟล์กำหนดค่า:

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

ตัวอย่างการกำหนดค่า (Windows)

เปิด (หรือสร้าง) claude_desktop_config.json และเพิ่ม:

{ "mcpServers": { "translate": { "command": "node", "args": [ "C:\Users\path\to\project\dist\index.js" ] } } }

⚠️ อย่าลืมอัปเดตพาธไปยัง dist/index.js ภายในเครื่องของคุณหลังจากสร้าง!

---

✅ วิธีตรวจสอบ

1. เปิด Claude Desktop
2. ป้อนคำขอเช่น:"ใช้เครื่องมือ MCP translatetext เพื่อแปล 'Hello world' เป็นภาษารัสเซีย"
3. หากทุกอย่างกำหนดค่าถูกต้อง Claude จะเรียกเซิร์ฟเวอร์ MCP ของคุณและส่งคืนคำแปล

---

📌 เครื่องมือที่พร้อมใช้งาน

translate_text

แปลข้อความจากภาษาหนึ่งไปยังอีกภาษาหนึ่ง

อาร์กิวเมนต์:

• text – ข้อความที่ต้องการแปล
• sourceLang – รหัสภาษาต้นทาง (เช่น "en")
• targetLang – รหัสภาษาปลายทาง (เช่น "ru")

ตัวอย่างคำขอ:

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

ตัวอย่างการตอบกลับ:

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

---