项目简介

EvolveMCP 是一个易于使用的 MCP 服务器实现,它基于 Python 构建,并利用 PowerShell 脚本提供了一套便捷的工具,用于扩展大型语言模型(LLM)的功能。通过 EvolveMCP,您可以轻松地为 Claude 等 LLM 添加自定义工具,实现更强大的交互和自动化能力。它基于 FastMCP 框架,简化了 MCP 服务器的搭建和工具的管理过程,即使是非专业开发者也能快速上手。

主要功能点

  • 工具 (Tools) 管理: 方便地创建、安装和管理自定义工具,扩展 LLM 的能力边界。例如,仓库中演示了计算器工具的创建和注册。
  • Claude 进程管理: 提供 PowerShell 命令来重启 Claude 桌面应用、查看日志等,方便服务器的维护和调试。
  • 简化 MCP 服务器配置: 无需复杂的编码即可设置 MCP 服务器,通过简单的 PowerShell 命令和配置文件即可完成服务器的部署和工具注册。
  • 交互式向导: 内置 'evolve_wizard' 工具,通过对话式的引导,帮助用户了解系统状态、安装示例工具、查看代码模板等。

安装步骤

  1. 环境准备:

    • 确保已安装 Windows 操作系统。
    • 确保已安装 PowerShell (Windows 自带)。
    • 确保已安装 Claude Desktop 客户端。
    • 确保已安装 Python (建议安装 Python 3.13 或更高版本,并添加到系统 PATH 环境变量)。
  2. 下载 EvolveMCP:

    • 可以从 GitHub Releases 下载最新版本的压缩包,解压到本地目录。
    • 或者使用 Git 命令克隆仓库:
      git clone https://github.com/kordless/EvolveMCP.git
      cd EvolveMCP
  3. 运行安装脚本:

    • 在 PowerShell 中,进入 EvolveMCP 解压或克隆后的目录。
    • 运行安装命令:'.\evolve.ps1 -Setup'
    • 该脚本会自动安装必要的 Python 包和进行初步配置。
  4. 重启 Claude:

    • 按照脚本提示,重启 Claude Desktop 客户端,使配置生效。

服务器配置

对于 MCP 客户端,需要配置连接到 EvolveMCP 服务器的信息。EvolveMCP 默认通过 'stdio' 传输协议运行,以下是 MCP 客户端配置示例 (JSON 格式):

{
  "servers": [
    {
      "name": "evolve-server",
      "command": "python",
      "args": ["evolve.py"]
    }
  ]
}

配置参数说明:

  • name: 服务器名称,例如 '"evolve-server"',这个名称需要在 Claude 的 MCP 配置中引用。
  • command: 启动服务器的命令,这里是 '"python"',假设您的 Python 可执行文件在系统 PATH 中。
  • args: 命令参数,这里是 '["evolve.py"]',指向 EvolveMCP 服务器主程序 'evolve.py' 文件。请确保 MCP 客户端配置中的 'evolve.py' 路径是相对于 EvolveMCP 仓库根目录的正确路径。如果客户端和服务器在同一目录下,直接使用 '"evolve.py"' 即可。

注意: 实际配置时,您需要将上述 JSON 配置添加到 Claude 客户端的 MCP 服务器配置中。具体配置方法请参考 Claude 客户端的 MCP 功能文档。EvolveMCP 自身已经包含了服务器运行代码,无需额外配置服务器端程序。

基本使用方法

  1. 启动服务器: EvolveMCP 服务器会在您运行 '.\evolve.ps1 -Setup' 后自动配置到 Claude 客户端中。当 Claude 启动并启用 MCP 功能后,EvolveMCP 服务器会自动启动。

  2. 使用内置工具:

    • 'evolve_status' 工具: 可以获取系统信息、Claude 状态和 MCP 日志。在 Claude 中,您可以直接调用 'evolve_status()' 来查看服务器状态。
    • 'evolve_wizard' 工具: 提供交互式向导,可以通过 'evolve_wizard()' 命令启动,并根据提示使用不同的子命令,例如 'evolve_wizard("status")' 查看系统状态,'evolve_wizard("calc")' 安装计算器示例工具。
  3. 管理工具和 Claude:

    • 使用 PowerShell 脚本 '.\evolve.ps1' 提供的命令,例如 '.\evolve.ps1 -Restart' 重启 Claude, '.\evolve.ps1 -ViewLogs' 查看日志, '.\evolve.ps1 -ListTools' 列出已安装工具等。
  4. 创建自定义工具: 您可以参考 'evolve_wizard("calc")' 命令创建计算器工具的示例代码,学习如何编写和注册自己的工具。工具代码需要放置在与 'evolve.py' 同目录下,并通过修改 Claude 的 MCP 配置文件来注册新的工具服务器。

通过 EvolveMCP 和 PowerShell 脚本,您可以方便地管理和扩展 Claude 的功能,定制更符合您需求的 LLM 应用体验。

信息

分类

开发者工具