Elixir MCP Server

🚀 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：能够获取天气信息。

客户端测试

可安装 NXP Inspector 客户端，并依照说明连接到服务器。需确保使用 SSE（Server-Sent Events）作为传输协议，这样就能列出可用工具并进行调用。此外，为维持连接的存活状态，可使用 ping 工具。

自定义工具添加

若要添加自定义工具，需更新 handle_initialize/2 函数以包含工具定义，并实现相应的 handle_call_tool/3 子句。