使用说明
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