Vancouver

Vancouver

Vancouver 可轻松为你的 Phoenix/Bandit 服务添加 Model Context Protocol (MCP) 功能。Vancouver 负责初始化、请求验证，并提供辅助函数，简化 MCP 工具和提示词的创建。

开始使用

1. 添加依赖

在 mix.exs 中：

defp deps do
  [
    {:vancouver, "~> 0.3"}
  ]
end

2. 创建工具/提示词

你可以这样实现工具：

defmodule MyApp.Tools.CalculateSum do
  use Vancouver.Tool

  def name, do: "calculate_sum"
  def description, do: "Add two numbers together"

  def input_schema do
    %{
      "type" => "object",
      "properties" => %{
        "a" => %{"type" => "number"},
        "b" => %{"type" => "number"}
      },
      "required" => ["a", "b"]
    }
  end

  def run(conn, %{"a" => a, "b" => b}) do
    send_text(conn, "#{a + b}")
  end
end

也可以这样实现提示词：

defmodule MyApp.Prompts.CodeReview do
  use Vancouver.Prompt

  def name, do: "code_review"
  def description, do: "Asks the LLM to analyze code quality and suggest improvements"

  def arguments do
    [
      %{
        "name" => "code",
        "description" => "The code to review",
        "required" => true
      }
    ]
  end

  def run(conn, %{"code" => code}) do
    send_text(conn, "Please review this code: #{code}")
  end
end

3. 添加配置

在 config.ex 中：

config :vancouver,
  name: "My MCP Server",
  version: "1.0.0"

4. 添加 MCP 路由

在 router.ex 中：

forward "/mcp", Vancouver.Router, 
  tools: [MyApp.Tools.CalculateSum],
  prompts: [MyApp.Prompts.CodeReview]

5. （可选）添加到你的 MCP 客户端

例如，对于 Claude Desktop，你可以按如下方式修改配置：Settings -> Developer -> Edit config：

{
    "mcpServers": {
        "MyApp": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "http://localhost:4000/mcp"
            ]
        }
    }
}

启动服务，然后重启 Claude，即可开始使用你的 MCP 工具。🚀

常见问题

Vancouver 支持 Model Context Protocol 规范的所有部分吗？

还不支持。Vancouver 目前支持：

• 工具
• 提示词
• 同步响应（不支持流式传输）

不过，这个库足够简单，你应该可以根据自己的需求对其进行修改。

有关协议本身的更多信息，请参阅 MCP User Guide。

Vancouver 稳定吗？可以用于生产环境吗？

不可以。这个库仍处于早期开发阶段，可能会有破坏性变更。

这个库为什么叫 Vancouver？

Vancouver 是 MCP（山脉、咖啡和 Phoenix）的天然家园。