MCP服务器工具

MCPMaker是一个帮助用户快速搭建、测试和部署Model Context Protocol (MCP)服务器的工具,提供CLI和Warp集成功能。

  • by eldrgeek
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 eldrgeek/MCPMaker

使用说明

MCPMaker

MCPMaker可帮助您使用fastmcp搭建、构建、测试和部署模型上下文协议(MCP)服务器。

您将获得:

  • 为新服务器克隆的最小fastmcp服务器模板
  • CLI(scripts/mcp.py)用于初始化deps、搭建新服务器、运行和测试它们,以及通过git分支进行部署
  • 在Warp中键入“/”以触发常见操作时显示的Warp工作流

先决条件

  • macOS或Linux(在macOS上测试)
  • Python 3.11+推荐
  • Git(用于分支/部署)
  • 可选:如果您希望部署命令自动打开PR,请使用GitHub CLI(gh)

快速启动

  1. 创建并激活venv并安装deps

    • 通过CLI:
      • python3-m视频
      • source.ven/bin/activate
      • pip安装-r要求.txt
    • 或使用助手:
      • python脚本/mcp.py初始化
  2. 从模板创建新服务器到服务器/<your_name>

    • python脚本/mcp.py新我的演示
    • 这可以选择创建一个分支服务器/my-demo,并在servers/my-demo下添加启动文件
  3. 运行服务器

    • HTTP:python scripts/mcp.py运行我的演示--传输HTTP--端口8000
    • STDIO:python scripts/mcp.py运行我的演示--传输STDIO
  4. 测试服务器

    • python脚本/mcp.py测试我的演示
  5. 部署(提交+推送分支,可选创建GitHub PR)

    • python脚本/mcp.py部署我的演示--创建pr
  6. 在Warp注册(通过MCPExecutionPath自动发现)

    • python脚本/mcp.py寄存器扭曲了我的演示
    • 这将在~/Library/Python/3.11/bin中安装一个包装器,Warp会扫描MCP服务器。
    • 要删除:python scripts/mcp.py unregister扭曲我的演示

扭曲斜线命令

  • 在Warp中键入“/”并查找MCP:命令(在.Warp/works/MCP.yaml中定义):
    • MCP:新服务器(脚手架)
    • MCP:运行服务器(HTTP)
    • MCP:运行服务器(STDIO)
    • MCP:测试服务器
    • MCP:部署分支

fastmcp的注意事项

  • fastmcp是一个用于定义MCP服务器的轻量级库。此项目在templates/fastmcp_sserver/mcp_server.py中包含一个最小模板,其中包含一个示例工具和HTTP/STDIO传输。
  • 有关从您提供的现有服务器中提取的简短指南和提示,请参阅docs/fastmcp.md。

存储库布局

  • scripts/mcp.py#用于项目自动化的基于Typer的CLI
  • templates/fastmcp_server/#最小服务器模板
  • 服务器/#您生成的服务器将位于此处
  • .warp/works/mcp.yaml#斜线命令的warp工作流
  • docs/fastmcp.md#fastmcp设置、使用和提示

故障排除

  • 如果基于STDIO的运行将任何非JSON-RPC的输出打印到stdout,则一些MCP客户端可能会失败。该模板避免在STDIO模式下打印到stdout。
  • 如果部署失败,请确保您的仓库已初始化(git init),并且您有一个远程设置(git remote add origin ).如果未安装gh,部署将推送分支,但跳过PR创建。