铸造厂
Bootstrap Now使用预加载的上下文、技能和模板辅助POC项目。
Foundry是一个MCP(模型上下文协议)服务器,可帮助AI Foundry团队快速启动具有一致结构、ServiceNow上下文和可重用技能的新POC/POV项目。
快速开始
先决条件
- GitHub CLI已通过身份验证黄金回购是私有的。跑
gh auth login第一。 - Node.js 18+:需要运行MCP服务器。
1.配置克劳德代码
将Foundry添加到您的Claude Code MCP配置中:
选项A:项目级 (.mcp.json 在您的工作目录中)
{
"mcpServers": {
"foundry": {
"command": "node",
"args": ["/path/to/foundry-mcp/dist/index.js"]
}
}
}选项B:全球 (~/.claude/config.json)
{
"mcpServers": {
"foundry": {
"command": "node",
"args": ["/path/to/foundry-mcp/dist/index.js"]
}
}
}2.启动一个新项目
在Claude Code中,使用 foundry_init 工具:
Create a new Now Assist POC called "customer-demo"克劳德将使用 foundry_init 创建:
customer-demo/
├── CLAUDE.md # SPARC methodology template
├── .gitignore
└── .claude/
├── context/ # 6 context files
│ ├── now-assist-platform.md
│ ├── genai-framework.md
│ ├── agentic-patterns.md
│ ├── troubleshooting-guide.md
│ ├── security-patterns.md
│ └── performance-tuning.md
└── skills/ # 6 skills with examples
├── now-assist-skill-builder/
├── api-integration/
├── servicenow-troubleshooting/
├── agent-builder/
├── testing-patterns/
└── deployment-automation/3.开始建设
cd customer-demo
claude # Opens Claude Code with pre-loaded context______________________________________________________________________
可用工具
铸造工具(12)
| 工具 | 说明 |
|---|---|
foundry_init | 启动一个新的Now Assist POC项目 |
foundry_list | 列出可用资源(上下文、技能、模板) |
foundry_add | 向现有项目添加资源 |
foundry_sync | 将项目资源更新到最新版本 |
foundry_info | 获取资源的详细信息 |
foundry_search | 搜索所有资源 |
foundry_new | 创建新资源(上下文文件或技能) |
foundry_validate | 推广前验证资源 |
foundry_promote | 向黄金回购提交资源 |
foundry_external | 管理外部插件(@approved/*@github/*) |
foundry_version | 管理资源版本并检查更新 |
foundry_templates | 列出并预览可用模板 |
ServiceNow工具(8)
| 工具 | 说明 |
|---|---|
servicenow_connect | 连接到ServiceNow实例 |
servicenow_disconnect | 断开与当前实例的连接 |
servicenow_status | 检查连接状态 |
servicenow_syslogs | 使用筛选器查询系统日志 |
servicenow_aia_logs | 获取AI代理执行跟踪 |
servicenow_query | 执行GlideRecord风格的查询 |
servicenow_script | 执行后台脚本(带安全栏) |
servicenow_instance | 获取实例信息和运行状况 |
______________________________________________________________________
黄金存储库内容
上下文文件(6)
| 文件 | 描述 |
|---|---|
now-assist-platform.md | Now Assist架构、功能、API |
genai-framework.md | GenAI控制器,技能调用模式 |
agentic-patterns.md | 代理框架、工具使用、编排 |
troubleshooting-guide.md | 常见问题、调试模式、系统日志 |
security-patterns.md | ACL、角色、安全编码实践 |
performance-tuning.md | 查询优化、缓存、最佳实践 |
技能(6)
| 技能 | 描述 |
|---|---|
now-assist-skill-builder | 创建自定义Now Assist技能 |
api-integration | ServiceNow REST API模式 |
servicenow-troubleshooting | 使用系统日志、AIA日志、脚本进行调试 |
agent-builder | 创建AI代理 |
testing-patterns | 单元测试、ATF、模拟 |
deployment-automation | CI/CD、更新集、应用发布 |
模板(3)
| 模板 | 说明 |
|---|---|
sparc-starter | 具有所有上下文和技能的完整SPARC方法(默认) |
standard | 仅上下文文件,无预加载技能 |
minimal | 仅限于CLAUDE.md |
______________________________________________________________________
仓库结构
snaifmcp/
├── README.md # This file
├── CLAUDE.md # Project guidance for Claude Code
├── DEMO_SCRIPT.md # Demo walkthrough guide
├── .mcp.json # MCP server configuration
├── foundry-mcp/ # MCP server implementation
│ ├── src/
│ │ ├── index.ts # Main server (Foundry tools)
│ │ └── servicenow/ # ServiceNow tools
│ ├── dist/ # Built server (ready to use)
│ └── test/ # Test suite
├── foundry-golden/ # Golden repository content
│ ├── context/ # 6 context files
│ ├── skills/ # 6 skills with examples
│ └── templates/ # 3 project templates
└── docs/
├── spec/ # Specifications
├── plan/ # Implementation plans & backlog
└── archive/ # Reference documentation______________________________________________________________________
发展
构建MCP服务器
cd foundry-mcp
npm install
npm run build运行测试
cd foundry-mcp
npm test # Run all tests (90 tests)
npm run test:keep # Run tests, keep output for inspection本地开发
cd foundry-mcp
npm run dev # Watch mode for TypeScript compilation______________________________________________________________________
文档
- 演示脚本 -完成演示演练
- 如何指导 -日常使用和测试
- MCP服务器自述文件 -服务器开发指南
- 黄金回购自述 -内容贡献指南
- 待办事项 -功能跟踪和路线图
______________________________________________________________________
示例工作流
创建新POC
Create a new Now Assist POC called "acme-incident-assistant"使用其他模板
Create a project called "quick-test" using the minimal template向现有项目添加技能
Add the testing-patterns skill to this project搜索资源
Search Foundry for "GlideRecord" content连接到ServiceNow并调试
Connect to my-dev-instance.service-now.com
Query recent syslogs with source "AI Agent"
Get the AIA logs for the last hour执行背景脚本
Run this script on ServiceNow in read-only mode:
var gr = new GlideRecord('incident');
gr.addQuery('active', true);
gr.setLimit(5);
gr.query();
while(gr.next()) { gs.info(gr.number); }______________________________________________________________________
路线图
- \[x\] 第一阶段(MVP):
foundry_init具有上下文、技能和SPARC模板 - \[x\] 第2阶段:
foundry_list,foundry_add,foundry_sync - \[x\] 第三期:
foundry_info,foundry_search - \[x\] 阶段4:
foundry_new,foundry_validate,foundry_promote - \[x\] 阶段5:外部插件、版本控制、多个模板
- \[x\] ServiceNow工具:连接、查询、系统日志、AIA日志、脚本
- \[ \] 技术债务:TypeScript严格模式、ESLint、集成测试
______________________________________________________________________
许可证
麻省理工学院
团队
AI铸造厂-立即服务
