Forge MCP (Believemanasseh)

锻造MCP服务器

Forge项目脚手架代理的模型上下文协议（MCP）服务器。该服务器充当大型语言模型（LLM）和Forge API之间的桥梁，使人工智能助手能够根据用户需求构建新项目。

概述

Forge MCP服务器使用FastMCP框架创建LLM可以用来与Forge项目脚手架API交互的工具。这允许AI助手基于自然语言描述生成项目结构、样板代码和配置。

特性

• 使用模型上下文协议轻松与LLM集成
• 连接至锻造项目脚手架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进行通信，使其与各种LLM集成框架兼容。

api参考

query_agent

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

参数：

• query （string）：项目到脚手架的自然语言描述

退货：

• Forge API的JSON响应

例子：

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

与MCP主机集成

集成光标或风帆

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

• 光标： ~/.cursor/mcp.json 或 .cursor/mcp.json
• 风浪： ~/.codeium/windsurf/mcp_config.json

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

集成克劳德桌面

在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工作区配置文件 .vscode/mcp.json:

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

贡献

我们欢迎为Forge MCP服务器项目做出贡献！以下是您如何做出贡献：

1. 分叉存储库 -创建自己的项目分支
2. 创建要素分支 - git checkout -b feature/your-feature-name
3. 提交您的更改 -确保写清楚提交消息
4. 推到您的分支 - git push origin feature/your-feature-name
5. 打开拉取请求 -描述你所做的更改以及为什么应该包括这些更改

开发指南

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

许可证

Apache许可证2.0