git clone https://github.com/pockees/quick-kg-mcp.git
cd quick-kg-mcp
npm install
npm run build

{
  "mcpServers": {
    "quick-kg-mcp": {
      "command": "node",
      "args": ["/path/to/quick-kg-mcp/dist/index.js"],
      "env": {
        "KG_BASE_DIR": "/path/to/your/knowledge-base",
        "KG_LLMS_TXT_URL": "https://docs.racorecloud.com/llms.txt",
        "KG_CRAWL_CONCURRENCY": "5"
      }
    }
  }
}

{
  "url": "https://docs.racorecloud.com/llms.txt",
  "output_folder": "/data/my-docs"
}

{
  "totalLinks": 85,
  "successCount": 83,
  "failureCount": 2,
  "failures": [
    { "url": "https://example.com/broken", "error": "HTTP 404: Not Found" }
  ],
  "savedTo": "/path/to/data/docs"
}

{
  "folder_path": "/data/docs/docs.racorecloud.com"
}

{
  "entitiesExtracted": 156,
  "relationshipsExtracted": 89,
  "filesProcessed": 85
}

{
  "folder_path": "/data/docs/docs.racorecloud.com",
  "special_instructions": "重点提取 API 端点和参数信息",
  "extraction_model": "detailed"
}

{
  "message": "Configuration saved successfully",
  "folderPath": "/data/docs/docs.racorecloud.com"
}

{
  "mode": "maintenance"
}

{
  "mode": "maintenance",
  "entitiesMerged": 12,
  "entitiesRemoved": 3,
  "relationshipsRemoved": 5,
  "message": "Maintenance complete. Merged 12 duplicate entities, removed 3 orphan entities and 5 invalid relationships."
}

{
  "file_path": "/data/docs/docs.racorecloud.com/api-416453366.md"
}

{
  "chunksIndexed": 8,
  "filePath": "/data/docs/docs.racorecloud.com/api-416453366.md",
  "message": "File registered for RAG search with 8 chunks."
}

{
  "directory_path": "/data/docs/docs.racorecloud.com"
}

{
  "filesIndexed": 85,
  "totalChunks": 642,
  "message": "Indexed 85 files with 642 total chunks from directory: /data/docs/docs.racorecloud.com"
}

{
  "query": "如何配置 CDN 加速域名",
  "folder_path": "/data/docs/docs.racorecloud.com"
}

{
  "results": [
    {
      "filePath": "/data/docs/docs.racorecloud.com/api-416453370.md",
      "content": "## 添加加速域名\n\n调用 AddCdnDomain 接口...",
      "similarity": 0.92
    }
  ],
  "total": 5
}

{
  "nodes": "[{\"name\": \"AddCdnDomain\", \"category\": \"API\", \"summary\": \"添加加速域名接口\"}]",
  "edges": "[{\"from_name\": \"AddCdnDomain\", \"to_name\": \"CDN\", \"relation\": \"belongs_to\"}]",
  "source_type": "manual"
}

{
  "nodesAdded": 1,
  "edgesAdded": 1,
  "message": "Added 1 nodes and 1 edges to the knowledge graph"
}

{
  "query": "CDN",
  "category": "API",
  "mode": "keyword",
  "include_edges": true
}

{
  "entities": [
    {
      "id": "abc-123",
      "name": "AddCdnDomain",
      "entityType": "API",
      "summary": "添加加速域名接口",
      "properties": {}
    }
  ],
  "edges": [
    {
      "sourceEntityId": "abc-123",
      "targetEntityId": "def-456",
      "relationshipType": "belongs_to"
    }
  ],
  "total": 1
}

<KG_BASE_DIR>/
├── docs/                     # 抓取的文档
│   └── docs.racorecloud.com/ # 按域名组织
│       ├── api-416453366.md
│       ├── api-416453367.md
│       └── ...
├── graph/                    # 知识图谱数据
│   ├── graph.json            # 实体和关系
│   └── folder-configs.json   # 文件夹提取配置
└── rag/                      # RAG 索引数据
    ├── chunks.json           # 文档分块
    └── vectors.json          # 向量嵌入

npm run dev          # 使用 tsx 热重载运行
npm run build        # TypeScript 编译
npm run test         # 运行测试
npm start            # 运行编译后的版本

src/
├── config.ts                 # 配置加载（环境变量 + 默认值）
├── errors.ts                 # 统一错误类型定义
├── types.ts                  # 共享类型定义
├── index.ts                  # 入口文件
├── server.ts                 # MCP Server 初始化与工具注册
├── graph/                    # 知识图谱模块
│   ├── graph-store.ts        # 图谱存储（实体/关系 CRUD）
│   ├── graph-extractor.ts    # 实体与关系提取器
│   ├── graph-search.ts       # 图谱搜索逻辑
│   └── folder-config.ts      # 文件夹配置管理
├── rag/                      # RAG 模块
│   ├── chunker.ts            # 文档分块器
│   ├── embedder.ts           # 向量嵌入器
│   └── vector-store.ts       # 本地向量存储
├── storage/                  # 存储抽象层
│   └── storage-manager.ts    # 文件读写管理
└── tools/                    # MCP 工具实现
    ├── crawl-docs.ts         # crawl_docs
    ├── kg-folder-rebuild.ts  # kg_folder_rebuild
    ├── kg-folder-configure.ts# kg_folder_configure
    ├── kg-build.ts           # kg_build
    ├── rag-register.ts       # register_file_for_rag
    ├── index-directory.ts    # index_directory
    ├── file-rag-search.ts    # file_rag_search
    ├── kg-add.ts             # kg_add
    └── kg-search.ts          # kg_search