MCP服务器脚手架工具

MCPForge是一个轻量级工具包,用于本地搭建和验证Model Context Protocol服务器。

  • by MukundaKatta
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MukundaKatta/MCPForge

使用说明

MCPForge

MCPForge是一个轻量级的工具包,用于在本地搭建和验证模型上下文协议服务器。

第一部分重点介绍两个实际工作流程:

  • mcpforge init 创建一个最小的stdio MCP启动器项目
  • mcpforge check 对本地服务器运行冒烟测试,并验证基本的MCP握手

为什么选择MCPForge

MCP服务器开发仍然有很多重复的设置工作:

  • 创建启动项目结构
  • 连接本地stdio服务器环路
  • 检查服务器是否启动并正确响应
  • 为下一个贡献者记录可运行的本地工作流

MCPForge的存在是为了使第一个设置和验证循环可重复。

安装

从存储库根目录:

python -m pip install -e .

用法

创建启动项目:

mcpforge init ./my-server

该命令生成:

  • server.py 使用最小的stdio MCP服务器
  • README.md 带有本地运行指令
  • .gitignore 用于基本Python工件

在本地运行生成的服务器:

cd my-server
python server.py

在另一个终端中,验证服务器:

mcpforge check .

成功的输出如下:

PASS: stdio server handshake succeeded.
Server: starter-mcp-server 0.1.0
Verified methods: initialize, tools/list, resources/list, prompts/list

当前范围

目前的实施有意规模较小:

  • 一个脚手架指挥
  • 一个本地stdio烟雾测试命令
  • 一个最小的项目模板

这足以使repo可用,同时保持第一个实现易于理解和扩展。

下一步

下一步可能的改进包括:

  • 更丰富的入门模板
  • 可配置的服务器名称和元数据
  • 更深入的MCP协议验证
  • CI友好检查输出
  • 打包和部署助手

项目结构

MCPForge/
├── .gitignore
├── README.md
├── pyproject.toml
└── mcpforge/
    ├── __init__.py
    ├── cli.py
    └── templates.py