MCP-Forge

基本能力

产品定位

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：

uvx mcp-forge --help

安装教程

全局安装或使用 pip 安装：

pip install mcp-forge
mcp-forge --help

创建新 MCP 服务器

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

调试方式

1. 进入项目目录：

cd my-awesome-server

1. 设置 Python 环境并安装依赖：

uv venv
uv pip install -e .

1. 运行服务器：

uv run python -m my_awesome_server.server_sse

1. 在另一个终端运行测试客户端：

uv run test_client.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。