AI导哈

MCP服务器扩展模板

一个用于快速打包MCP服务器作为ai-factory扩展的模板，适用于跨代理分发MCP服务器配置。

  • by dealenx
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dealenx/ai-factory-extension-mcp-template

使用说明

ai工厂扩展mcp模板

将MCP服务器打包为 ai工厂 扩展。使用它可以在ai工厂管理的所有代理之间快速分发一个或多个MCP服务器。

快速开始

  1. 点击 “使用此模板” 在GitHub上根据此模板创建自己的存储库，然后克隆它。或者，直接分叉或克隆此存储库。
  2. 编辑 extension.json --设置您的分机号 name, version, description，并列出中的每个MCP服务器 mcpServers 阵列。
  3. 对于每台服务器，在 mcp/ 目录。
  4. 将扩展安装到您的项目中：
# from a local directory
ai-factory extension add ./ai-factory-extension-mcp-template

# or from a git repo
ai-factory extension add https://github.com/<user>/<repo>.git

就是这样——ai工厂将MCP服务器配置合并到支持MCP的每个代理（Claude Code、Cline等）中。

项目结构

ai-factory-extension-mcp-template/
├── extension.json       # Extension manifest (required)
├── mcp/                 # MCP server templates
│   └── playwright.json  # Example: Playwright MCP server
├── package.json
├── LICENSE
└── README.md

运作原理

扩展名.json

清单声明了扩展提供的MCP服务器：

{
  "name": "ai-factory-extension-mcp-template",
  "version": "1.0.0",
  "description": "Template: hello MCP server inside ai-factory extension",
  "mcpServers": [
    {
      "key": "playwright",
      "template": "./mcp/playwright.json",
      "instruction": "Playwright MCP: Install Chrome to use a web browser"
    }
  ]
}
字段 描述
key 代理设置文件中服务器条目的唯一标识符。
template 包含服务器命令、args和env的JSON文件的路径。
instruction 安装后向用户显示的消息（例如所需的环境变量）。

MCP模板(mcp/*.json)

每个模板都遵循标准的MCP服务器格式：

{
  "command": "npx",
  "args": ["@playwright/mcp@latest"]
}

您还可以传递环境变量：

{
  "command": "npx",
  "args": ["-y", "@my-org/my-mcp-server"],
  "env": {
    "MY_API_KEY": "${MY_API_KEY}"
  }
}

添加更多MCP服务器

  1. 在中创建新模板文件 mcp/例如。 mcp/my-server.json.
  2. 向添加新条目 mcpServers 数组in extension.json:
{
  "key": "my-server",
  "template": "./mcp/my-server.json",
  "instruction": "Set MY_API_KEY environment variable before use"
}
  1. 重新安装扩展程序以应用：
ai-factory extension remove ai-factory-extension-mcp-template
ai-factory extension add ./ai-factory-extension-mcp-template

管理扩展

# List installed extensions
ai-factory extension list

# Remove the extension (cleans up MCP entries from agent configs)
ai-factory extension remove ai-factory-extension-mcp-template

文档

  • ai工厂扩展指南 --扩展清单字段、MCP服务器、注入、命令、技能和代理的完整参考。

许可证

麻省理工学院

相关 MCP