相位清单生成器MCP
使用模型上下文协议辅助人工智能生成Phaset清单。
利用Claude的智能生成最小MCP服务器 phaset.manifest.json 通过分析您的存储库来创建文件。
_这可能适用于也可能不适用于其他MCP兼容工具，如ChatGPT，但除了Claude之外，还没有对任何其他工具进行测试。_
快速开始
先决条件
你需要 安装。
配置
克劳德桌面
（macOS）：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json
（Windows）：编辑 %APPDATA%\Claude\claude_desktop_config.json
添加：
{
"mcpServers": {
"phaset": {
"command": "npx",
"args": ["-y", "phaset-mcp"]
}
}
}完全重新启动克劳德桌面。
克劳德代码
将以下内容添加到 .claude.json:
{
"mcpServers": {
"phaset": {
"command": "npx",
"args": ["-y", "phaset-mcp"]
}
}
}命令行界面
运行：
claude mcp add phaset -- npx -y phaset-mcp用法
在克劳德桌面中：
Generate a Phaset manifest for /path/to/your/project克劳德将：
- 收集相关文件（package.json、README、Dockerfile等）
- 分析您的项目结构
- 生成带有置信度注释的清单
- 将需要手动输入的字段标记为TODO
主要特点
- 100%符合相位要求：生成的清单严格符合Phaset架构
- 智能分析：利用Claude对代码和配置的原生理解
- 有用的注解：推理注释作为补充文本呈现
- 多个深度级别：选择最小、标准或深度文件分析
- 语言不可知论：可使用克劳德理解的任何语言
可用工具
get_phaset_schema
返回Phaset集成API模式，以便Claude理解清单结构。
collect_repo_files
根据深度从存储库中智能收集相关文件：
- 最小：仅包清单和README
- 标准：添加Dockerfiles、CI/CD配置、API规范
- 深：包括基础设施配置（Terraform、Kubernetes）
suggest_manifest
编排完整的工作流程：检索架构、收集文件并生成完整的清单草稿。
建筑
┌─────────────────┐
│ User's IDE │
│ (Claude Code) │
└────────┬────────┘
│
▼
┌──────────────────────────┐
│ Phaset MCP Server │
│ • get_phaset_schema() │
│ • collect_repo_files() │
│ • suggest_manifest() │
└────────┬─────────────────┘
│
▼
┌──────────────────────────┐
│ Claude (via MCP) │
│ • Analyzes files │
│ • Generates manifest │
│ • Provides confidence │
└──────────────────────────┘生成什么
高置信度领域✅
克劳德可以可靠地推断：
name,description,version（来自包文件）kind（api/服务/库/组件）sourcingModel（自定义vs开源）deploymentModel（云/saas/本地部署）tags（检测到的语言和框架）api定义（来自OpenAPI/Swagger规范）- 外部依赖
需要手动输入⚠️
标记为TODO的字段：
repo（您的Phaset组织/记录格式）group,system,domain（组织ID）dataSensitivity,businessCriticality（商业决策）dependencies.target（阶段记录ID）slo,baseline,metadata
输出示例
生成的响应包括两部分：有效的JSON清单和单独的推理注释。
清单
{
"spec": {
"repo": "TODO: YOUR_ORG/YOUR_RECORD_ID",
"name": "user-api",
"description": "RESTful API for user management",
"kind": "api",
"lifecycleStage": "production",
"version": "2.3.1",
"group": "TODO: 8-CHAR-ID",
"dataSensitivity": "TODO: MANUAL",
"sourcingModel": "custom",
"deploymentModel": "public_cloud"
},
"tags": ["typescript", "express", "postgresql", "rest-api"],
"api": [
{
"name": "User API",
"schemaPath": "TODO: PUBLIC_URL_TO_SCHEMA"
}
]
}推理笔记（以文本形式呈现）
- 规格名称：HIGH-在package.json中找到
- 规格说明：HIGH-摘自README.md
- 规格种类：HIGH-根据OpenAPI规范和REST端点确定为API
- 规范版本：HIGH-在package.json中找到
- spec.lifecycle阶段：MEDIUM-根据生产Docker配置推断
- spec.repo：手册-需要组织/记录ID格式
- 规格组：手动-无法确定组织组ID
- 规范.数据敏感性：手册-需要商业决策
- 规格采购模型：HIGH-从存储库结构中可以明显看出定制开发
- 规格配置型号：中等-根据Kubernetes配置推断
- 标签：HIGH-从package.json依赖项和文件类型中检测到
- api.name：HIGH-来自OpenAPI规范标题
- api.schemaPath：手动-需要托管架构的公共URL
最佳结果提示
- 保持README更新 -Claude从文档中提取描述
- 使用标准文件 -自动检测package.json、Dockerfile等文件
- 文档API -包括用于API检测的OpenAPI/Swagger规范
- 提供代码所有者 -帮助识别联系人
- 更多文件=更好的推理 -使用“深度”分析获得全面结果
资源和链接
许可证
MIT。请参阅 LICENSE 文件。