AI导哈

模型上下文协议工具

一个基于Rust的模型上下文协议（MCP）服务器，充当大型语言模型（如Gemini）与嵌套工具链之间的桥梁，支持多级嵌套工具调用。

  • by jmikedupont2
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 jmikedupont2/copilot_mcp_tool

使用说明

copilot_mcp_t工具

发展计划和现状

copilot_mcp_tool 是一个基于Rust的模型上下文协议（MCP）服务器，旨在充当像Gemini这样的大型语言模型（LLM）之间的桥梁（通过 copilot-client)以及一系列嵌套的工具。本项目演示了如何使用MCP创建多级嵌套工具调用系统。

项目结构

该项目已被重构为客户端守护进程架构，由单个二进制文件管理： copilot_mcp_tool.

  • copilot_mcp_tool （主二进制）： 这是核心应用程序，同时充当服务器和客户端。
    • 服务器模式： 当开始时 start，它作为一个独立的后台进程运行，监听MCP连接。
    • 客户端模式： 当与以下命令一起使用时 list 或 call，它连接到正在运行的服务器实例以执行命令。
  • mcp_web_client （二进制）： 一个简单的基于web的GUI，连接到 copilot_mcp_tool 服务器提供用于调用工具的用户界面。
  • 嵌套工具模块： 该项目仍包含 WeatherTool, TimeTool，以及 EchoTool 演示多级嵌套工具调用。

先决条件

在开始之前，请确保已安装以下内容：

安装和设置

  1. 克隆存储库：

    git clone https://github.com/jmikedupont2/copilot_mcp_tool.git
cd copilot_mcp_tool

  2. 设置您的GitHub令牌： 该项目依赖于 GITHUB_TOKEN 用于使用Copilot API进行身份验证的环境变量。

    要设置此项，您可以提取GitHub CLI令牌（通常具有必要的作用域）并将其保存到 .env 文件。

    # Extract your GitHub token using gh CLI and save to .env
# Note: This requires gh CLI to be logged in.
# On Windows PowerShell:
(gh auth token).Trim() | Set-Content -Path .\.env -Value { "GITHUB_TOKEN=" + $_ }

# On Linux/macOS or Git Bash:
# gh auth token > .env
# echo "GITHUB_TOKEN=$(cat .env)" > .env
# Note: The above two lines are a quick hack. A safer way is:
# echo "GITHUB_TOKEN=$(gh auth token)" > .env

    重要提示： 对于 GITHUB_TOKEN 由以下人员取走 cargo run，你 必须 在执行命令之前，确保它已加载到shell的环境中。

    • 手动（Windows命令提示符）： set GITHUB_TOKEN=YOUR_TOKEN_HERE
    • 手动（Windows PowerShell）： $env:GITHUB_TOKEN="YOUR_TOKEN_HERE"
    • 手动（Linux/macOS/Git Bash）： export GITHUB_TOKEN="YOUR_TOKEN_HERE"
    • 使用 direnv （建议开发）： 安装 direnv 并添加 eval "$(direnv hook bash)" （或与shell等效的）到shell配置。然后，简单地说 export GITHUB_TOKEN=YOUR_TOKEN_HERE 在你的 .envrc 文件，或者如果您更喜欢重用 .env 上面创建的文件，put source .env 在你的 .envrc.

  3. 构建项目：

    cargo build

用法

这 copilot_mcp_tool 是一个命令行工具，用于管理MCP服务器并与之交互。

管理服务器

首先，构建项目：

cargo build

检查服务器状态： 默认情况下，不带参数运行该工具会显示服务器状态。

cargo run --bin copilot_mcp_tool
# Or, more explicitly:
cargo run --bin copilot_mcp_tool -- status
# Output: Server is STOPPED.

启动服务器： 这将启动服务器作为后台进程。

cargo run --bin copilot_mcp_tool -- start
# Output:
# Server starting in background...
# Server is RUNNING on port 58361 (PID: 12345).

停止服务器：

cargo run --bin copilot_mcp_tool -- stop
# Output:
# INFO copilot_mcp_tool: Stopping server (PID: 12345)...
# INFO copilot_mcp_tool: Server stopped.

与服务器交互

服务器运行后，您可以使用客户端命令。

列出可用工具：

cargo run --bin copilot_mcp_tool -- list

这将连接到正在运行的服务器并打印可用工具的JSON列表(echo_message 和 kill_process).

调用工具： 这 call 命令使用a tool_name 然后是参数的键值对。

# Example with a simple message
cargo run --bin copilot_mcp_tool -- call echo_message message=hello

# Example with spaces in the value (use quotes)
cargo run --bin copilot_mcp_tool -- call echo_message message="hello world"

该工具将连接到服务器，执行命令，并打印JSON结果。

使用Web GUI

该项目还包括一个简单的web客户端。

  1. 启动MCP服务器：

    cargo run --bin copilot_mcp_tool -- start

  2. 运行web客户端： 在单独的终端中：

    cargo run --bin mcp_web_client

    web客户端将启动并继续监听 http://localhost:3000.

  3. 打开浏览器 并导航到 http://localhost:3000 通过web界面与服务器交互。

贡献

请随时打开问题或拉取请求，以改进嵌套MCP工具调用的演示。

相关 MCP