项目简介

Context Foundry是一个基于Model Context Protocol (MCP) 构建的服务器,旨在为LLM(特别是Claude Code CLI)提供高级自主软件开发能力。它能够将自然语言任务转化为完整的软件项目,并自动化执行需求研究、架构设计、代码实现、测试修复、截图、文档生成及GitHub部署等8个核心阶段。其独特之处在于通过Meta-MCP递归地调用Claude Code实例,实现AI自我协调与并行执行,极大地提高了开发效率和项目质量。

主要功能点

  • 全链路自主软件开发: 从零开始,无需人工干预,自动完成从Scout(需求调研)到Deploy(GitHub部署)的全部软件生命周期阶段。
  • 自修复测试循环: 自动运行测试,并在失败时智能分析原因并进行代码修复,最多可尝试3次迭代。
  • Meta-MCP递归调用: 独特地利用MCP协议递归生成新的Claude Code实例,每个实例拥有独立的上下文窗口,实现并行任务处理和高效上下文管理。
  • 背景构建与实时监控: 构建任务在后台异步运行,用户可继续工作,并通过TUI或Web仪表板实时监控任务进展。
  • 智能增量构建: 通过文件级变更检测和依赖图分析,重用缓存的Scout报告和测试结果,大幅加速重复构建(最高可提速70-90%)。
  • 全球模式库学习: 自动从成功构建中提取和学习模式,并贡献到全局知识库,提升未来构建的智能水平。
  • 丰富工具集: 提供任务委托、异步任务管理、任务取消、实时输出流、全局模式读写及社区分享等MCP工具。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/context-foundry/context-foundry.git
    cd context-foundry
  2. 创建并激活Python虚拟环境:
    python3 -m venv venv
    source venv/bin/activate
    (Windows用户请使用 'venv\Scripts\activate')
  3. 安装MCP服务器依赖:
    pip install -r requirements-mcp.txt
    (可选:安装BAML以启用类型安全的LLM输出,请运行 'pip install -r requirements-baml.txt')
  4. 配置GitHub CLI (用于部署):
    gh auth login
    (如果尚未安装 'gh' CLI,请先安装。)

服务器配置

MCP客户端(如Claude Code CLI)需要配置Context Foundry MCP服务器的启动命令。以下是标准的JSON配置示例:

{
  "mcpServers": {
    "context-foundry": {
      "command": "/绝对路径/到/context-foundry/venv/bin/python",
      "args": [
        "/绝对路径/到/context-foundry/tools/mcp_server.py"
      ],
      "transport": "stdio",
      "description": "Context Foundry MCP Server for autonomous software development"
    }
  }
}

说明:

  • 将 '/绝对路径/到/context-foundry/' 替换为 'context-foundry' 仓库在你系统中的实际绝对路径。例如,如果仓库克隆在 '/Users/youruser/projects/context-foundry',则路径应为 '/Users/youruser/projects/context-foundry/venv/bin/python'。
  • 'command': 指向虚拟环境中的Python解释器,用于启动MCP服务器。
  • 'args': 启动MCP服务器脚本的路径。
  • 'transport': 建议使用 'stdio' 协议,这是MCP客户端与服务器通信的标准方式。
  • 'description': 对MCP服务器的简要描述,有助于客户端识别。

基本使用方法

  1. 启动Claude Code CLI: 在 'context-foundry' 仓库的根目录或您希望项目创建的父目录中运行:
    claude
    (确保您已激活包含Context Foundry依赖的虚拟环境。)
  2. 向Claude Code CLI提问 (自然语言): 直接用自然语言描述您想要构建的项目,Claude Code会自动识别并调用Context Foundry的自主构建工具。
    • '构建一个带有当前天气和5天预报功能的Express.js天气API,使用OpenWeatherMap API。'
    • '创建一个待办事项应用,包含添加、完成和删除功能。'
    • '编写一个带用户认证和PostgreSQL的REST API。'
  3. 等待构建完成: 构建任务将在后台自主运行(通常7-15分钟)。您可以在Claude Code CLI中继续其他工作。
  4. 检查构建状态: 您可以随时提问查询构建状态:
    • '我的构建任务状态如何?'
    • '待办应用构建的进展如何?'
    • '任务 abc-123-def-456 完成了吗?' 或者直接调用MCP工具:
    • '使用 mcp__get_delegation_result with task_id "abc-123-def-456"'
  5. 获取结果: 构建完成后,您将收到通知,包含部署到GitHub的链接、测试报告和生成的文件列表。

信息

分类

开发者工具