Elixir MCP Server

🚀 Elixir MCP 服務器

Elixir MCP 服務器是一個使用 Elixir 實現的模型上下文協議（MCP）服務器，基於 Bandit 和 Plug 構建。模型上下文協議（MCP）是開放協議，能讓 AI 模型藉助標準化服務器，安全地與本地和遠程資源進行交互。本項目是使用 SSE（Server-Sent Events）作為傳輸協議的基礎 MCP 服務器示例，參考自：https://modelcontextprotocol.io/quickstart/server。

🚀 快速開始

先決條件

• Elixir 1.18 或更高版本
• Erlang/OTP 27 或更高版本
• 天氣 API 密鑰可通過 WEATHER_API_KEY 環境變量設置。默認服務使用的是免費層級的 https://www.weatherapi.com/。

操作步驟

1. 安裝依賴：

mix deps.get

2. 啟動服務器：

WEATHER_API_KEY="1234567890abcdef" mix run --no-halt

3. 服務器端點：
   • SSE 端點：http://localhost:4000/sse
   • 消息端點：http://localhost:4000/message

✨ 主要特性

可用工具

• list_files：列出目錄中的文件
• echo：回顯消息
• get_weather：獲取天氣信息

使用 MCP 客戶端測試

安裝 NXP Inspector 客戶端，並按說明連接到服務器。確保使用 SSE（Server-Sent Events）作為傳輸協議，即可列出可用工具並調用。此外，可使用 ping 工具保持連接存活。

添加自定義工具

要添加自定義工具，需更新 handle_initialize/2 函數以包含工具定義，並實現相應的 handle_call_tool/3 子句。