项目简介

这是一个基于Model Context Protocol (MCP) 实现的服务器，用于将支持MCP的AI Agents（如Claude、Cursor等）与MagicPod平台连接起来。它通过实现标准的MCP协议，向AI Agents暴露MagicPod相关的API功能和知识库搜索能力，使AI Agents能够理解和操作MagicPod。

主要功能点

• MagicPod API 调用: 将MagicPod的Web API（通过OpenAPI规范定义）转换为AI Agent可调用的工具，允许AI Agent执行诸如管理资源、触发操作等API任务。
• MagicPod 知识库搜索: 提供搜索MagicPod帮助中心文章的工具，帮助AI Agent获取最新的MagicPod操作指南和技术信息。
• MagicPod 文章阅读: 提供阅读指定MagicPod帮助中心文章的工具，深入了解特定主题。
• 文件上传: 提供向MagicPod云上传测试所需应用文件（如 .app, .ipa, .apk, .aab）的工具。
• 标准MCP协议支持: 通过 StdIo 传输协议与MCP客户端（AI Agents）通信，接收并处理工具调用等请求。

安装步骤

该服务器可以通过npm安装或直接使用npx运行。最简单的运行方式是使用npx。

1. 确保你的系统已安装 Node.js。
2. AI Agent（MCP客户端）在启动时会按需运行此服务器。

服务器配置

本MCP服务器通常由AI Agent（MCP客户端）根据其配置启动。你需要在你的AI Agent的MCP服务器配置中指定如何启动此服务器，并传入必要的参数，特别是你的MagicPod API Token。

例如，在某些AI Agent的配置文件（如 'claude_desktop_config.json' 或类似文件）中，你需要添加一个MCP服务器条目。以下是配置时需要提供的信息及其说明：

• 'server name': 给你的MCP服务器起一个唯一的名称，例如 'magicpod-mcp-server'。
• 'command': 指定启动服务器的命令。对于使用npx方式，通常是 'npx'。
• 'args': 指定传递给命令的参数列表。
  • 第一个参数是服务器的npm包名称，例如 'magicpod-mcp-server'。
  • '-y': npx 的一个标志，用于自动确认安装。
  • '--api-token <YOUR-API-TOKEN>': 这是必须提供的参数，用于向MagicPod API进行认证。你需要将 '<YOUR-API-TOKEN>' 替换为你实际的MagicPod API Token。这个Token可以在你的MagicPod账户设置页面中获取。

配置完成后，AI Agent启动时会读取此配置，并按需启动该MCP服务器进程，通过标准输入/输出进行通信。

基本使用方法

一旦AI Agent配置并成功启动了MagicPod MCP服务器，你就可以像平常一样与AI Agent进行交互。AI Agent会根据你的对话内容，自动识别何时需要调用MagicPod相关的工具。例如，当你询问有关MagicPod操作、需要上传文件或查询项目信息时，AI Agent可能会调用这个MCP服务器提供的工具来获取信息或执行操作。

你无需直接与MCP服务器进程交互，它是在后台为AI Agent提供服务。