Elixir MCP Server

Elixir MCP サーバー

Bandit と Plug を使用した、Elixir による Model Context Protocol（MCP）サーバーの実装です。

Model Context Protocol（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. The server will be available at:

   • SSE endpoint: http://localhost:4000/sse
   • Message endpoint: http://localhost:4000/message

Available Tools

• list_files: List files in a directory
• echo: Echo a message back
• get_weather: Get weather information

Testing with MCP Client

Install the NXP Inspector client and follow the instructions to connect to the server.

Make sure to use SSE (Server-Sent Events) as the transport protocol, then you should be able to list available tools and call them. Also to ping/keepalive the connection, you can use the ping tool.

Adding Custom Tools

To add custom tools, update the handle_initialize/2 function to include your tool definitions and implement corresponding handle_call_tool/3 clauses.