基本能力
产品定位
MCP-Forge 是一个用于快速生成 MCP 服务器项目的脚手架工具,帮助开发者快速启动项目。
核心功能
- 生成完整的 Python 项目结构,适用于 MCP 服务器。
- 提供 SSE 和 stdio 传输的独立服务器入口点。
- 包含示例工具(如
HelloWorld
)和资源(如HelloWorld
和UserProfile
)。 - 使用 Pydantic 模型定义清晰的输入/输出模式。
- 提供基本的测试客户端(
test_client.py
),演示服务器交互。 - 使用
uv
进行依赖管理和任务运行。
适用场景
- 快速启动 MCP 服务器项目。
- 学习和理解 MCP 协议及其实现。
- 开发自定义工具和资源,扩展 MCP 服务器的功能。
工具列表
HelloWorld
工具:示例工具,展示基本的输入/输出功能。HelloWorld
资源:示例静态资源。UserProfile
资源:示例动态资源,支持 URI 参数。
常见问题解答
- 项目处于早期阶段:API 和功能可能会随着 MCP 生态系统的发展而变化。
- 如何支持开发:可以通过 PayPal 捐赠支持项目开发。
使用教程
使用依赖
确保已安装 uv
:
bash
uvx mcp-forge --help
安装教程
全局安装或使用 pip
安装:
bash
pip install mcp-forge
mcp-forge --help
创建新 MCP 服务器
bash
uvx mcp-forge new my-awesome-server
生成的项目结构
my-awesome-server/
├── my_awesome_server/
│ ├── __init__.py
│ ├── server_stdio.py
│ ├── server_sse.py
│ ├── interfaces/
│ │ ├── __init__.py
│ │ ├── resource.py
│ │ └── tool.py
│ ├── resources/
│ │ ├── __init__.py
│ │ ├── hello_world.py
│ │ └── user_profile.py
│ ├── services/
│ │ ├── __init__.py
│ │ ├── resource_service.py
│ │ └── tool_service.py
│ └── tools/
│ ├── __init__.py
│ └── hello_world.py
├── pyproject.toml
├── test_client.py
└── README.md
调试方式
- 进入项目目录:
bash
cd my-awesome-server - 设置 Python 环境并安装依赖:
bash
uv venv
uv pip install -e . - 运行服务器:
bash
uv run python -m my_awesome_server.server_sse - 在另一个终端运行测试客户端:
bash
uv run test_client.py