AI导哈

MCP服务器调试工具

TRMX MCP Playground是一款开源的桌面工具，用于探索、调试和监控模型上下文协议（MCP）服务器，内置LLM集成，适用于开发者在本地或远程环境中构建和测试MCP服务器。

  • by rosaboyle
  • TypeScript
  • 本地部署
  • 33 星标
  • 更新于
在 GitHub 查看 rosaboyle/mcp-playground

使用说明

TRMX MCP游乐场

MCP的邮递员
一个强大的开源桌面工具，用于探索、调试和监控模型上下文协议（MCP）服务器，内置LLM集成。
了解更多信息并加入我们的社区 trmx.ai.

目录

  1. 什么是TRMX MCP游乐场？
  2. 我们为什么建造它
  3. 欢迎：开源和开发者社区
  4. 主要特点
  5. 安装
  6. 使用指南
  7. 集成示例
  8. 用例
  9. 故障排除
  10. 指挥线探索
  11. 许可与确认

什么是TRMX MCP游乐场？

TRMX MCP Playground是您构建、测试、调试和监控MCP服务器的首选工具。
把它想象成“邮递员，但对MCP来说。”
它专为使用模型上下文协议（MCP）的开发人员而设计，MCP是一种让LLM（大型语言模型）以一致的方式发现和使用外部工具、资源和提示的标准。

我们为什么建造它

我们注意到MCP的开发人员体验被破坏了——测试、调试和监控MCP服务器是痛苦的。
我们的愿景是双重的：

  1. 第一阶段： 为开发人员构建一个本地MCP游乐场，以便轻松构建、测试、调试和监控他们的本地MCP。
  2. 第二阶段： 启动无服务器MCP平台，这样任何人都可以部署、扩展和共享MCP，而无需管理基础设施。

阅读更多关于我们的动机和路线图：

欢迎：开源和开发者社区

我们将TRMX MCP Playground开源，因为我们相信MCP的未来应该由社区为社区构建。
我们不仅在寻找用户，我们还在寻找合作者、贡献者和开拓者。

  • 官方工作组：
    我们成立了一个开放的官方工作组，以指导项目的方向，确定优先事项，并共同构建下一代MCP工具。
  • 周例会：
    加入我们的定期会议，讨论功能，分享反馈，并帮助制定路线图。日历更新即将到来！
  • 开放式协作：
    欢迎所有贡献——代码、文档、想法和反馈。
    如果你想帮助定义MCP服务器的构建和使用方式，你来对地方了。

加入我们：

主要特点

  • MCP服务器调试：连接到任何MCP服务器并探索其工具、资源和提示。
  • 内置LLM集成：直接与Fireworks AI和Groq（即将推出更多）等LLM提供商联系。
  • 工具和资源勘探：列出并检查MCP服务器上的所有可用工具、资源和提示。
  • 多个并行连接：同时连接并监控多个MCP服务器。
  • 综合录井：所有操作和响应的详细本地日志。
  • 现代界面：简洁直观的用户界面，便于交互。
  • 开源：100%开放，麻省理工学院授权，并基于社区反馈构建。

安装

先决条件

  • Node.js（v20.16.0或更高版本）
  • npm（10.8.1或更高版本）

安装步骤

# Clone the repository
git clone https://github.com/rosaboyle/mcp-playground.git

# Navigate to the project directory
cd mcp-playground

# Install dependencies
npm install

# Build the project
npm run build

# Start the application
npm start

使用指南

设置API密钥

您可以通过应用程序的用户界面轻松设置API密钥：

  1. 打开应用程序并导航到“提供者”部分
  2. 单击要配置的提供程序的“设置API密钥”
  3. 在对话框中输入API密钥并保存

添加MCP服务器

要通过用户界面添加新的MCP服务器：

  1. 导航到应用程序中的“MCP游乐场”
  2. 点击“添加服务器”并填写服务器详细信息
  3. 点击“保存”以保存服务器配置

添加新的MCP服务器

要添加新的MCP服务器，请执行以下操作：

  1. 使用MCP游乐场部分的“添加服务器”按钮
  2. 指定服务器名称、命令、参数和环境变量
  3. 保存配置

发展

# Start the application in development mode
npm run dev

测试

运行测试套件：

npm test

有关测试的详细信息，请参阅 测试.md.

集成示例

烟花AI集成

MCP Playground允许Fireworks AI模型：

  1. 发现MCP服务器上的可用工具
  2. 在适当的时候调用这些工具
  3. 处理工具调用的结果
  4. 根据工具输出生成连贯的响应

有关更多详细信息，请参阅 消防工程_MCP_INTEGRATION.md.

Groq集成

Groq集成实现了：

  • 使用API密钥初始化Groq客户端
  • 对Groq API进行真正的API调用
  • Groq AI模型的流式聊天完成
  • 将事件从流转发到渲染器进程

有关更多详细信息，请参阅 GROQ_INTEGRATION.md.

用例

  • API测试：调试和测试您的MCP服务器实现
  • 工具开发：为MCP服务器开发和测试新工具
  • LLM集成：测试不同LLM如何与MCP工具交互
  • 教育：了解模型上下文协议
  • 发展：构建利用MCP和LLM的应用程序

故障排除

常见问题

  • 连接错误：确保您的MCP服务器正在运行，并且MCP.json中的/args命令正确
  • API关键问题：验证您是否在.env文件中设置了正确的API密钥
  • 工具调用失败：检查服务器日志中的工具实现错误

对于具体的集成问题：

有关已知问题和限制的列表，请参阅 知识_问题.md.

指挥线探索

对于高级用户或故障排除，您还可以通过命令行浏览MCP服务器：

npm run mcp-client

这将：

  • 连接到已配置的MCP服务器
  • 列出所有可用工具
  • 列出所有可用资源
  • 列出所有可用提示

通过命令行测试LLM集成

该应用程序支持通过命令行使用MCP服务器测试各种LLM提供程序：

烟花AI+MCP

# Test the Fireworks MCP integration
npx ts-node src/test_fireworks_mcp.ts

# Run in interactive mode
npx ts-node src/test_fireworks_mcp.ts --interactive

格鲁克 + MCP

# Test the Groq integration
npx ts-node src/test_groq.ts

贡献

欢迎投稿！请随时提交拉取请求。

看 贡献.md 了解如何为该项目做出贡献的详细指南。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

致谢

  • 感谢所有帮助构建和改进此工具的贡献者
  • 特别感谢MCP社区开发和推广此标准

相关 MCP