项目脚手架协议服务器

Forge MCP Server是一个连接大型语言模型和Forge项目脚手架API的协议服务器,用于根据用户需求生成项目结构和配置。

  • by believemanasseh
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 believemanasseh/forge-mcp

使用说明

锻造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