AI导哈

POC项目引导工具

Foundry是一个MCP服务器，帮助AI Foundry团队快速启动新的POC/POV项目，提供一致的结构、ServiceNow上下文和可重用技能。

  • by gapietro
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gapietro/snaifmcp

使用说明

铸造厂

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

文档

示例工作流

创建新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铸造厂-立即服务

相关 MCP