MCP Project Generator

MCP项目生成器

为什么这个项目存在

“将职位描述转化为人工智能架构工件”

“表明高级/员工准备就绪”

“投资组合驱动的MCP系统”

将任何职位描述转化为人工智能驱动的架构和投资组合项目

此存储库提供 可重复框架 和一个 Python MCP服务器 将任何技术职位描述转化为：

• AI+MCP项目概念
• 结构化架构案例研究
• 高级技术组合工件

您可以通过三种方式使用它：

1. 手动（仅提示） –将提示和模板复制到ChatGPT（或其他LLM）中，并粘贴职位描述。
2. 具有真正LLM的MCP服务器 –运行附带的Python MCP服务器，让工具直接从Cursor或其他MCP主机生成和保存项目规范（需要 OPENAI_API_KEY).
3. MCP服务器处于本地测试模式 –运行服务器，无需 OPENAI_API_KEY 以生成在没有外部API调用的情况下执行完整管道的确定性存根规范。

______________________________________________________________________

仓库结构

template/   → Universal MCP project document structure  
prompts/    → Ready-to-use generation prompt  
examples/   → Sample generated projects  
project_generator.py → LLM + file-writing logic  
server.py   → MCP server exposing project generation tools  
requirements.txt → Python dependencies  
generated_projects/ → (created at runtime) generated project folders  

______________________________________________________________________

设置

从 mcp-project-generator 目录：

python -m venv .venv
.venv\Scripts\activate    # PowerShell / Windows
pip install -r requirements.txt

设置OpenAI环境变量（PowerShell示例） 用于真正的LLM通话:

$env:OPENAI_API_KEY = "sk-..."
$env:OPENAI_MODEL = "gpt-4o-mini"   # optional

如果你 不要 集 OPENAI_API_KEY，服务器将在本地运行 测试模式:

• 没有进行外部API调用。
• 生成的规格明确标记为测试输出，但仍写入 generated_projects//project_spec.md.

______________________________________________________________________

运行MCP服务器

python server.py

服务器使用stdio传输（stdin/stdout），并在服务器id下公开工具 mcp-project-generator.

光标MCP配置

将此服务器添加到Cursor的MCP配置中（例如 ~/.cursor/mcp.json).为了获得最佳效果，将Cursor指向此项目virtualenv中的Python：

{
  "mcpServers": {
    "mcp-project-generator": {
      "command": "C:\\Users\\dolgo\\Desktop\\ai_projects\\mcp-project-generator\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\dolgo\\Desktop\\ai_projects\\mcp-project-generator\\server.py"]
    }
  }
}

______________________________________________________________________

工具

generate_portfolio_project_from_text

• 参数:

- job_description （string）–原始职位描述文本。 - project_name （可选字符串）–首选项目标题。

• 行为:

- 用途 prompts/generate_mcp_project.txt 和 template/MCP_Project_Template.md. - 如果 OPENAI_API_KEY 设置后，调用配置的OpenAI模型来生成结构化的Markdown项目规范。 - 如果 OPENAI_API_KEY 是 不 set，在本地测试模式下运行，并生成一个小的确定性存根规范（对布线测试有用）。 - 将结果写入 generated_projects//project_spec.md. - 返回人类可读的摘要和完整的Markdown内容。

generate_portfolio_project_from_url

• 参数:

- url （string）–可公开访问的职位描述URL。 - project_name （可选字符串）。

• 行为:

- 作为职位描述，抓取并轻轻清理页面内容。 - 学员与同一台发电机 generate_portfolio_project_from_text. - 以相同的方式保存和返回规格。

______________________________________________________________________

示例：Arista技术解决方案工程师项目

这 examples/arista-technical-solutions-engineer.md 文件显示了以下项目的完整编写的项目规范：

• 角色：技术解决方案工程师——云、超大规模和人工智能网络。
• 概念：使用MCP工具的“网络TAC AI复制品”，用于：

- 从AI/超大规模结构（L1-L3、QoS/PFC、光学、SONiC、Linux）收集遥测数据。 - 运行结构化诊断（例如。 get_interface_errors, get_bgp_flaps, capture_packets). - 生成TAC风格的根本原因分析和客户准备报告。

这可以作为如何将MCP项目与特定职位描述相匹配的参考，同时清楚地展示网络深度、故障排除技能和面向客户的沟通。

______________________________________________________________________

仅手动提示使用

如果您不想运行MCP服务器：

1. 复制职位描述。
2. 打开 prompts/generate_mcp_project.txt 并将其内容粘贴到ChatGPT中。
3. 出现提示时粘贴职位描述。
4. 使用 template/MCP_Project_Template.md 作为结构参考。
5. 将生成的架构另存为新的项目文件 examples/.

______________________________________________________________________

目标

帮助工程师演示：

• 建筑思维
• 人工智能驱动的自动化设计
• 具有商业意识的工程
• 高级/员工准备就绪

______________________________________________________________________

许可证

麻省理工学院