项目简介
EvolveMCP 是一个易于使用的 MCP 服务器实现,它基于 Python 构建,并利用 PowerShell 脚本提供了一套便捷的工具,用于扩展大型语言模型(LLM)的功能。通过 EvolveMCP,您可以轻松地为 Claude 等 LLM 添加自定义工具,实现更强大的交互和自动化能力。它基于 FastMCP 框架,简化了 MCP 服务器的搭建和工具的管理过程,即使是非专业开发者也能快速上手。
主要功能点
- 工具 (Tools) 管理: 方便地创建、安装和管理自定义工具,扩展 LLM 的能力边界。例如,仓库中演示了计算器工具的创建和注册。
- Claude 进程管理: 提供 PowerShell 命令来重启 Claude 桌面应用、查看日志等,方便服务器的维护和调试。
- 简化 MCP 服务器配置: 无需复杂的编码即可设置 MCP 服务器,通过简单的 PowerShell 命令和配置文件即可完成服务器的部署和工具注册。
- 交互式向导: 内置 'evolve_wizard' 工具,通过对话式的引导,帮助用户了解系统状态、安装示例工具、查看代码模板等。
安装步骤
-
环境准备:
- 确保已安装 Windows 操作系统。
- 确保已安装 PowerShell (Windows 自带)。
- 确保已安装 Claude Desktop 客户端。
- 确保已安装 Python (建议安装 Python 3.13 或更高版本,并添加到系统 PATH 环境变量)。
-
下载 EvolveMCP:
- 可以从 GitHub Releases 下载最新版本的压缩包,解压到本地目录。
- 或者使用 Git 命令克隆仓库:
git clone https://github.com/kordless/EvolveMCP.git cd EvolveMCP
-
运行安装脚本:
- 在 PowerShell 中,进入 EvolveMCP 解压或克隆后的目录。
- 运行安装命令:'.\evolve.ps1 -Setup'
- 该脚本会自动安装必要的 Python 包和进行初步配置。
-
重启 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 自身已经包含了服务器运行代码,无需额外配置服务器端程序。
基本使用方法
-
启动服务器: EvolveMCP 服务器会在您运行 '.\evolve.ps1 -Setup' 后自动配置到 Claude 客户端中。当 Claude 启动并启用 MCP 功能后,EvolveMCP 服务器会自动启动。
-
使用内置工具:
- 'evolve_status' 工具: 可以获取系统信息、Claude 状态和 MCP 日志。在 Claude 中,您可以直接调用 'evolve_status()' 来查看服务器状态。
- 'evolve_wizard' 工具: 提供交互式向导,可以通过 'evolve_wizard()' 命令启动,并根据提示使用不同的子命令,例如 'evolve_wizard("status")' 查看系统状态,'evolve_wizard("calc")' 安装计算器示例工具。
-
管理工具和 Claude:
- 使用 PowerShell 脚本 '.\evolve.ps1' 提供的命令,例如 '.\evolve.ps1 -Restart' 重启 Claude, '.\evolve.ps1 -ViewLogs' 查看日志, '.\evolve.ps1 -ListTools' 列出已安装工具等。
-
创建自定义工具: 您可以参考 'evolve_wizard("calc")' 命令创建计算器工具的示例代码,学习如何编写和注册自己的工具。工具代码需要放置在与 'evolve.py' 同目录下,并通过修改 Claude 的 MCP 配置文件来注册新的工具服务器。
通过 EvolveMCP 和 PowerShell 脚本,您可以方便地管理和扩展 Claude 的功能,定制更符合您需求的 LLM 应用体验。
信息
分类
开发者工具