Fabkit文档服务

为Fabkit Svelte 5 UI库提供的模型上下文协议服务器,部署在Cloudflare Worker上,使代理能够获取准确、最新的组件文档。

  • by fabricatorsltd
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 fabricatorsltd/fabkit-mcp

使用说明

Fabkit MCP服务器

A. 模型上下文协议 服务器 Fabkit公司 Svelte 5 UI库,部署为 Cloudflare工作人员.

代理(Claude、Cursor、Copilot……)可以调用此服务器以获取准确、最新的Fabkit文档,而不会产生组件名称、道具或图标名称的幻觉。


暴露的工具

工具 说明
list_components 所有组件均按类别分组,并带有可选过滤器
get_component 单个组件的完整文档(道具、示例、注释)
search_components 在所有组件文档中进行全文搜索
get_theming 完成主题化API:initTheme,CSS变量,暗模式
search_icons 按关键字搜索1500+荧光粉图标→ 精确的Ph*名称
get_pattern 即用型Svelte代码模式(应用程序外壳、仪表板等)
list_patterns 列出所有可用模式

快速开始

1.安装依赖项

npm install

2.本地运行

npm run dev
# → http://localhost:5173

3.部署到Cloudflare Workers

npm run deploy
# → https://fabkit-mcp.fabricators.dev

连接到克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "fabkit": {
      "url": "https://fabkit-mcp.fabricators.dev/mcp",
      "transport": "http"
    }
  }
}

连接到游标

在 .cursor/mcp.json:

{
  "mcpServers": {
    "fabkit": {
      "url": "https://fabkit-mcp.fabricators.dev/mcp"
    }
  }
}

连接到Gemini CLI

在 ~/.gemini/settings.json:

{
  "mcpServers": {
    "fabkit": {
      "url": "https://fabkit-mcp.fabricators.dev/mcp"
    }
  }
}

注: Gemini CLI不支持 transport key--仅限使用 url.

连接到GitHub Copilot CLI

在 ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "fabkit": {
      "type": "http",
      "url": "https://fabkit-mcp.fabricators.dev/mcp",
      "tools": ["*"]
    }
  }
}

或者,运行 /mcp add 在CLI内部,以交互方式填写字段。

连接到VS代码

在 .vscode/mcp.json (工作空间)或 ~/.config/Code/User/mcp.json (全球):

{
  "servers": {
    "fabkit": {
      "type": "http",
      "url": "https://fabkit-mcp.fabricators.dev/mcp"
    }
  }
}

注: VS代码使用 "servers" (不是 "mcpServers")作为根密钥。

连接到Continue.dev

在 ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "fabkit",
      "type": "streamable-http",
      "url": "https://fabkit-mcp.fabricators.dev/mcp"
    }
  ]
}

连接到Windsurf

在 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "fabkit": {
      "serverUrl": "https://fabkit-mcp.fabricators.dev/mcp"
    }
  }
}

注: 风帆用途 "serverUrl" (不是 "url")用于远程HTTP服务器。


MCP协议

服务器实现 MCP 2024-11-05 结束 可流式传输的HTTP (职位 /mcp).

所有请求都是JSON-RPC 2.0:

# Initialize
curl -X POST https://fabkit-mcp.fabricators.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{}},"id":1}'

# List tools
curl -X POST https://fabkit-mcp.fabricators.dev/mcp \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# Call a tool
curl -X POST https://fabkit-mcp.fabricators.dev/mcp \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_component","arguments":{"name":"Button"}},"id":3}'

扩展知识库

编辑 src/knowledge.ts --向添加条目 COMPONENTS 数组或扩展 ALL_ICONS.
编辑 src/tools.ts --向添加新条目 PATTERNS 对象。
然后重新部署: npm run deploy.


建筑

src/
  index.ts      ← Cloudflare Worker entry, routing, CORS
  mcp.ts        ← JSON-RPC 2.0 dispatch, tool registry
  knowledge.ts  ← All Fabkit docs embedded as typed data
  tools.ts      ← Tool implementations (pure functions)

一切皆有可能 无状态 --没有KV,没有R2,没有外部API。
Worker在<5ms内冷启动,因为所有知识都是内联的。