AI导哈

语义搜索服务器

一个基于模型上下文协议（MCP）的服务器，用于对架构指南和实施规则进行语义搜索，是SnapKit生态系统的一部分。

  • by gufoscuro
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gufoscuro/snapkit-blueprint-mcp

使用说明

SnapKit蓝图MCP

一个模型上下文协议（MCP）服务器，用于在架构指南和实现规则上进行语义搜索。部分 SnapKit 生态系统。

与SnapKit的关系

此MCP服务器旨在与 SnapKit，一个基于SvelteKit构建的人工智能辅助定制框架。虽然SnapKit提供了运行时体系结构（页面注册表、组件发现、状态共享），但此服务器公开了 建筑知识 AI代理。

当与Claude Code或其他MCP兼容工具集成时，AI助手可以查询实现模式、组件指南和架构决策，使他们能够生成遵循SnapKit约定的代码，而无需手动共享上下文。

请参阅 SnapKit MCP服务器生态系统 了解这如何适应更广泛的工具。

特性

  • markdown文档的语义搜索
  • 使用Google Gemini API嵌入生成
  • 快速内存向量搜索
  • 自定义文档的可配置内容目录

设置

  1. 安装依赖项：
npm install
  1. 创建 .env 使用您的配置文件：
GOOGLE_API_KEY=your_api_key_here
CONTENT_DIR=/path/to/your/docs  # Optional
  1. 生成嵌入：
npm run build:embeddings
  1. 构建项目：
npm run build

环境变量

变量 必填 描述
GOOGLE_API_KEY 是 用于生成和查询嵌入的Google Gemini API密钥
CONTENT_DIR 否 包含markdown文档的文件夹的路径。默认为 ./content
EMBEDDINGS_PATH 否 嵌入JSON文件的路径。默认为 ./embeddings/embeddings.json

使用自定义内容目录

您可以指向任何包含markdown文件的文件夹：

# Using an environment variable
CONTENT_DIR=/path/to/snapkit/.blueprints npm run build:embeddings

# Or in your .env file
CONTENT_DIR=/path/to/snapkit/.blueprints

文件夹必须存在，否则嵌入生成将失败并出现错误。

使用Claude代码

将此MCP服务器添加到您的Claude Code配置中(~/.config/claude-code/mcp_config.json):

{
  "mcpServers": {
    "snapkit-blueprint": {
      "command": "node",
      "args": [
        "/path/to/snapkit-blueprint-mcp/dist/index.js"
      ],
      "env": {
        "GOOGLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

或者，将其全球链接：

# In this repository
npm link

# Then in your MCP config:
{
  "mcpServers": {
    "snapkit-blueprint": {
      "command": "npx",
      "args": ["snapkit-blueprint-mcp"],
      "env": {
        "GOOGLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

配置后，重新启动Claude Code。这 search_blueprint 工具将可用。

项目结构

├── content/           # Default markdown documentation
├── embeddings/        # Generated embeddings (auto-created)
├── scripts/           # Embedding generation script
└── src/               # MCP server and search logic

相关 MCP