Froggy MCP测试仪
用于测试模型上下文协议（MCP）服务器的Electron应用程序。此工具提供了一个用户友好的界面，可以连接到MCP服务器，浏览可用工具，并使用自定义参数执行它们。
特性
- 多种运输支持：通过以下方式连接到MCP服务器：
- 工作室：通过命令行运行本地MCP服务器进程 - 表征状态转移：通过HTTP/HTTPS端点连接到远程MCP服务器
- 服务器管理：添加、编辑和删除MCP服务器配置
- 工具发现：自动发现并列出连接服务器中的所有可用工具
- 工具执行：通过直观的表单界面执行具有自定义参数的工具
- 永久存储：服务器配置保存在本地，并在会话之间保持不变
- 窗口状态：记住窗口大小和位置
先决条件
- Node.js（v14或更高版本）
- npm（附带Node.js）
安装
- 克隆或下载此存储库
- 安装依赖项：
npm install用法
启动应用程序
npm start开发模式：
npm run dev添加MCP服务器
- 点击 “+添加服务器” 按钮
- 输入服务器的名称
- 选择运输类型：
- 工作室：输入运行MCP服务器的命令（例如。， node server.js 或 python mcp_server.py) - 表征状态转移：输入MCP REST API端点的基本URL（例如。， https://api.example.com/mcp)
- 对于REST服务器，可选择提供API密钥进行身份验证
- 点击 保存
使用工具
- 从服务器列表中选择服务器
- 可用工具将显示在右侧面板中
- 对于每种工具：
- 查看工具说明和参数 - 填写所需参数（标有\*） - 可选择填写可选参数 - 点击 执行工具 运行该工具
- 在每个工具下方的结果容器中查看结果
服务器管理
- 编辑：单击服务器旁边的“编辑”按钮以修改其配置
- 删除：单击“删除”按钮删除服务器配置
- 选择：单击服务器名称查看其工具
运输类型
标准运输
stdio传输将MCP服务器作为本地进程运行。服务器地址应该是一个可以在终端中执行的命令，以及任何必要的参数。
例子：
node /path/to/mcp-server.js
python -m mcp_server --config config.jsonREST传输
REST传输通过HTTP/HTTPS连接到MCP服务器。服务器地址应该是MCP REST API端点的基本URL。
例子：
https://api.example.com/mcp
http://localhost:8080/mcp对于需要身份验证的REST服务器，您可以选择提供API密钥。密钥将以以下两种方式发送：
Authorization: Bearer头球X-API-Key:头球
数据存储
服务器配置存储在：
- 视窗:
%APPDATA%/froggy-mcp-tester/mcp-servers.json - macOS:
~/Library/Application Support/froggy-mcp-tester/mcp-servers.json - Linux:
~/.config/froggy-mcp-tester/mcp-servers.json
窗口边界（大小和位置）也会被保存，以保留您首选的窗口布局。
项目结构
froggy-mcp-tester/
├── main.js # Electron main process
├── preload.js # Preload script for secure IPC
├── renderer.js # Renderer process (UI logic)
├── mcp-client.js # MCP client implementation
├── index.html # Application UI
├── styles.css # Application styles
└── package.json # Project configuration依赖项
- 电子：^28.0.0-电子框架
- @模型上下文协议/sdk：^0.5.0-用于stdio传输的MCP SDK
发展
该应用程序使用Electron的上下文隔离来保证安全。主要流程处理：
- 窗口管理
- 文件系统操作（保存/加载服务器配置）
- MCP客户端连接
渲染器进程处理：
- UI渲染和用户交互
- 表单验证
- 显示结果
进程之间的通信通过预加载脚本使用Electron的IPC（进程间通信）。
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交问题或拉取请求。