Forge MCP Server

Forge MCP Server

用于 Forge 项目脚手架 Agent 的 Model Context Protocol（MCP）服务。此服务充当大模型与 Forge API 之间的桥梁，使 AI 助手能够根据用户需求搭建新项目。

概述

Forge MCP Server 使用 FastMCP 框架创建工具，供大模型与 Forge 项目脚手架 API 交互。这使 AI 助手能够根据自然语言描述生成项目结构、样板代码和配置。

功能

• 使用 Model Context Protocol 轻松集成大模型
• 连接 Forge 项目脚手架 API
• 简单的项目生成查询接口
• 错误处理和超时管理

前提条件

• Python 3.13+
• Pipenv

安装

克隆代码仓库：

git clone https://github.com/believemanasseh/forge-mcp.git
cd forge-mcp

安装依赖：

pipenv --python 3.13
source .venv/bin/activate
pipenv install

开发

运行服务

fastmcp dev server.py

默认情况下，服务使用 stdio 进行通信，因此兼容各种大模型集成框架。

API 参考

query_agent

向 Forge API 发送查询请求并返回结果。

参数：

• query（字符串）：要搭建的项目的自然语言描述

返回值：

• Forge API 返回的 JSON 响应

示例：

query_agent("Create a Django project named deet.")

与 MCP 宿主集成

集成 Cursor 或 Windsurf

在以下位置更新配置文件：

• Cursor：~/.cursor/mcp.json 或 .cursor/mcp.json
• Windsurf：~/.codeium/windsurf/mcp_config.json

{
    "mcpServers": {
        "forge-mcp": {
            "command": "pipenv",
            "args": ["run", "fastmcp", "run", "server.py"],
            "transport": "stdio"
        }
    }
}

集成 Claude Desktop

在 Claude Desktop 中，前往 Settings > Developer > Edit Config。将配置替换为：

{
    "mcpServers": {
        "forge-mcp": {
            "command": "pipenv",
            "args": [
                "run",
                "fastmcp",
                "run",
                "server.py"
            ],
            "cwd": "/path/to/your/forge-mcp"
        }
    }
}

注意：将 /path/to/your/forge-mcp 替换为克隆后的 forge-mcp 目录的绝对路径。

集成 VSCode

在 .vscode/mcp.json 更新 VSCode 工作区配置文件：

{
    "servers": {
        "forge-mcp": {
            "type": "stdio",
            "command": "pipenv",
            "args": ["run", "fastmcp", "run", "server.py"],
        }
    }
}

参与贡献

欢迎为 Forge MCP Server 项目贡献！以下是参与方式：

1. Fork 代码仓库 - 创建项目的个人分叉
2. 创建功能分支 - git checkout -b feature/your-feature-name
3. 提交更改 - 请确保编写清晰的提交消息
4. 推送到分支 - git push origin feature/your-feature-name
5. 发起拉取请求 - 说明所做的更改以及纳入这些更改的原因

开发指南

• Python 代码遵循 PEP 8 风格指南
• 为所有函数、类和方法编写文档字符串
• 为新功能添加适当的单元测试
• 更新文档以反映任何更改

许可证

Apache License 2.0