mcp_proxy_elixir 的安装和配置教程

1. 项目基础介绍和主要编程语言

mcp_proxy_elixir 是一个使用 Elixir 编写的开源项目，它主要作为一个中间件，允许 STDIO 基础上的 MCP 客户端连接到基于 HTTP（SSE）的 MCP 服务器。该项目特别适用于需要与遵循特定规范（如 2024-11-05）的 MCP 服务器进行通信的场景。

2. 项目使用的关键技术和框架

该项目主要使用了以下技术和框架：

• Elixir：一种功能性的、并发的、垃圾回收的编程语言，运行在 Erlang 虚拟机上。
• HTTP（SSE）：服务器发送事件（Server-Sent Events）是一种仅服务器到客户端单向通信的技术，允许服务器推送数据到浏览器。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装 mcp_proxy_elixir 之前，请确保您的系统中已经安装了以下依赖项：

• Elixir：确保您的系统中已经安装了 Elixir。如果没有安装，可以访问 Elixir 官方网站下载并安装。
• Hex：Elixir 的包管理器，通常与 Elixir 一起安装。

安装步骤

1. 克隆项目仓库

   打开命令行，使用 git 命令克隆项目仓库到本地：

   git clone https://github.com/tidewave-ai/mcp_proxy_elixir.git
   

   克隆完成后，您将得到一个名为 mcp_proxy_elixir 的文件夹。

2. 进入项目目录

   进入到克隆下来的项目目录中：

   cd mcp_proxy_elixir
   

3. 安装依赖

   在项目目录中，运行以下命令来安装项目依赖：

   mix deps.get
   

4. 构建项目

   安装完依赖后，构建项目：

   mix compile
   

5. 安装 escript

   构建完成后，使用 mix 命令安装 escript 到本地环境：

   mix escript.install local mcp_proxy
   

   安装成功后，escript 将被安装到您的 HOME/.mix/escripts 目录下。

6. 配置和使用

   • 设置环境变量：您可以通过设置环境变量 SSE_URL 来指定 SSE 服务器的 URL。

     export SSE_URL="http://localhost:4000/tidewave/mcp"
     

   • 运行中间件：在命令行中运行以下命令来启动中间件服务：

     ./mcp-proxy
     

     如果需要，您也可以使用 --debug 选项来启用调试信息。

   • 客户端配置：在客户端配置文件中，根据操作系统的不同，设置命令和参数。以下是在 macOS/Linux 和 Windows 上配置客户端的一个示例：

     macOS/Linux:

     {
       "mcpServers": {
         "my-server": {
           "command": "/path/to/escript",
           "args": ["/$HOME/.mix/escripts/mcp-proxy", "http://localhost:4000/tidewave/mcp"]
         }
       }
     }
     

     Windows:

     {
       "mcpServers": {
         "my-server": {
           "command": "escript.exe",
           "args": ["c:\\$HOME\\.mix\\escripts\\mcp-proxy", "http://localhost:4000/tidewave/mcp"]
         }
       }
     }
     

     在上述配置中，请确保将 $HOME 替换为您的实际家目录路径。

通过上述步骤，您应该能够成功安装和配置 mcp_proxy_elixir 项目，并进行使用了。