使用说明

项目简介

Hex MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，专门为大型语言模型（LLM）客户端提供 Elixir Hex 包的实时版本信息。该服务旨在帮助开发者在使用 AI 辅助编程工具（如 Cursor）时，能够获取准确且最新的 Hex 包版本建议，从而确保 Elixir 项目依赖的正确性和时效性。

主要功能点

实时 Hex 包版本查询： 提供对 hex.pm 官方 Elixir 包仓库的访问能力，实时查询最新的软件包版本信息。
MCP 协议支持： 遵循 Model Context Protocol 标准，通过 JSON-RPC 协议与客户端通信，提供标准化的上下文数据服务。
SSE 传输协议： 支持 Server-Sent Events (SSE) 传输协议，实现与客户端的实时数据推送。
Cursor 集成： 特别优化了与 Cursor 编辑器的集成，可以直接在 Cursor 中配置使用，提升 Elixir 项目的 AI 辅助开发体验。

安装步骤

安装 Elixir 和 Phoenix 环境: 确保您的开发环境中已安装 Elixir 和 Phoenix Framework。您可以参考 Phoenix 官方文档进行安装。

获取仓库代码: 从 GitHub 克隆 'hex-mcp' 仓库到本地：

git clone https://github.com/9elements/hex-mcp.git
cd hex-mcp

安装依赖: 在项目根目录下运行 'mix setup' 命令安装项目依赖：
```
mix setup
```
启动服务器: 运行 'mix phx.server' 命令启动 Phoenix 服务器：
```
mix phx.server
```
服务器默认将在 'localhost:4000' 启动。为了配合 Cursor 等客户端配置，您可能需要配置 '/etc/hosts' 文件，将 'hex-mcp.localhost' 指向 '127.0.0.1'。

服务器配置

对于 MCP 客户端（例如 Cursor），您需要配置以下信息以连接到 Hex MCP Server。以下是 Cursor 配置 MCP 服务器的 JSON 格式示例，其他 MCP 客户端的配置方式可能类似，请参考对应客户端的文档。

{
  "servers": [
    {
      "name": "Hex MCP Server",  //  服务器名称，您可以自定义
      "command": "mix",      //  启动服务器的命令，这里使用 mix
      "args": ["phx.server"],    //  启动命令的参数，phx.server 用于启动 Phoenix 服务器
      "url": "https://hex-mcp.9elements.com/sse"  //  服务器 URL，对于 Cursor 客户端，直接使用提供的在线服务URL即可。如果您本地部署，请替换为您的本地服务地址，例如 "http://hex-mcp.localhost:4000/sse"
    }
  ]
}

基本使用方法

配置 MCP 客户端: 在您的 MCP 客户端（如 Cursor）中，按照其文档指引配置 MCP 服务器连接信息，填入上述提供的服务器配置信息。
在 Elixir 项目中使用: 在 Cursor 等支持 MCP 的编辑器中打开您的 Elixir 项目。当您编辑 'mix.exs' 文件，添加或修改依赖项时，Hex MCP Server 将自动为客户端提供实时的 Hex 包版本建议。

注意: 如果您使用在线服务 'https://hex-mcp.9elements.com/sse'，则无需本地安装和配置服务器。您只需在 MCP 客户端中配置该 URL 即可直接使用 Hex MCP Server 提供的服务。本地部署适用于希望自定义配置或离线使用的场景。

关键词

使用说明

信息