MCP-Proxy Elixir 项目启动与配置教程

MCP-Proxy Elixir 项目启动与配置教程

mcp_proxy_elixir A proxy to use SSE MCPs from STDIO clients 项目地址: https://gitcode.com/gh_mirrors/mc/mcp_proxy_elixir

1. 项目的目录结构及介绍

MCP-Proxy Elixir 是一个使用 Elixir 语言编写的项目，用于将基于 STDIO 的 MCP 客户端连接到基于 HTTP（SSE）的 MCP 服务器。以下是项目的目录结构及其简要介绍：

mcp_proxy_elixir/
├── .formatter.exs         # Elixir 代码格式化配置文件
├── .gitignore            # Git 忽略文件列表
├── CHANGELOG.md          # 项目更新日志
├── LICENSE               # 项目许可证文件
├── README.md             # 项目说明文件
├── mix.exs               # Mix 项目配置文件
├── mix.lock              # Mix 依赖锁文件
├── lib/                  # Elixir 应用库代码目录
│   └── mcp_proxy.ex      # MCP-Proxy 主模块文件
├── test/                 # 测试代码目录
│   └── test_helper.exs   # 测试辅助文件
└── workflows/            # GitHub Actions 工作流目录

2. 项目的启动文件介绍

项目的启动主要通过 Mix 任务来实现。在根目录下，运行以下命令安装依赖并编译项目：

$ mix deps.get
$ mix compile

mix.exs 文件是 Mix 的项目配置文件，其中定义了项目的依赖、任务以及其他配置信息。以下是 mix.exs 文件的部分内容：

defmodule McpProxy.MixProject do
  use Mix.Project

  def project do
    [
      app: :mcp_proxy,
      version: "0.1.0",
      elixir: "~> 1.10",
      start_permanent: Mix.env() == :prod,
      deps: deps()
    ]
  end

  # 定义项目依赖
  defp deps do
    [
      # 依赖项
    ]
  end
end

启动项目，可以通过执行以下命令来运行 mcp_proxy escript：

$ mix escript.install hex mcp_proxy
$ /path/to/home/.mix/escripts/mcp-proxy http://localhost:4000/tidewave/mcp

确保替换 http://localhost:4000/tidewave/mcp 为你的 MCP 服务器地址。

3. 项目的配置文件介绍

MCP-Proxy Elixir 项目主要通过环境变量和命令行参数来进行配置。下面介绍几个重要的配置选项：

• SSE_URL：指定 SSE MCP 服务器的 URL。
• --debug：开启调试模式，将在标准错误输出中打印调试信息。
• --max-disconnected-time：设置在尝试重新连接时允许的最大断开连接时间。
• --receive-timeout：设置等待 MCP 服务器回复的最大时间（毫秒）。

这些配置可以在运行 escript 时作为参数传入，例如：

$ /path/to/home/.mix/escripts/mcp-proxy --debug http://localhost:4000/tidewave/mcp

确保根据你的需求调整配置参数，以确保项目能够正确运行。

mcp_proxy_elixir A proxy to use SSE MCPs from STDIO clients 项目地址: https://gitcode.com/gh_mirrors/mc/mcp_proxy_elixir