AI导哈

知识图谱管理服务

一个用于创建、管理、分析和可视化知识图谱的MCP协议服务，支持多种图谱类型和资源管理，适用于AI辅助的知识整合与查询场景。

  • by aiuluna
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 aiuluna/knowledge-graph-mcp

使用说明

知识图谱MCP服务器

用于创建、管理、分析和可视化知识图的模型上下文协议（MCP）服务。该服务完全符合MCP标准，并与MCP兼容的AI助手（如Claude）无缝集成。

中文文档

核心功能

  • 多种图形类型：支持拓扑结构、时间线、变更日志、需求文档、知识库、本体等
  • 完整的错误处理：清晰的错误信息和常见问题的处理建议
  • 资源管理：支持SVG和Markdown资源关联和管理
  • 版本状态：支持多种状态管理，包括草稿、发布和存档

安装和配置

通过Smithery安装

通过以下方式自动安装克劳德桌面知识图mcp 史密瑟里:

npx -y @smithery/cli install @aiuluna/knowledge-graph-mcp --client claude

需求

  • Node.js>=16.0.0
  • pnpm>=7.0.0

配置知识图谱目录

创建一个目录来存储知识图数据，例如：

mkdir ~/knowledge_graph

游标中的用法

将以下配置添加到Cursor配置文件中：

{
  "mcpServers": {
    "knowledge-graph": {
      "command": "npx",
      "args": [
        "-y",
        "@aiuluna/knowledge-graph-mcp"
      ],
      "env": {
        "KNOWLEDGE_GRAPH_DIR": "/path/to/your/knowledge_graph/dir"
      }
    }
  }
}

注：

  • 替换 KNOWLEDGE_GRAPH_DIR 使用您的实际知识图存储目录路径
  • 您可以指定特定的版本号，例如 @0.0.1

在Claude Desktop中的使用

将以下配置添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "knowledge-graph": {
      "command": "npx",
      "args": [
        "-y",
        "@aiuluna/knowledge-graph-mcp"
      ],
      "env": {
        "KNOWLEDGE_GRAPH_DIR": "/path/to/your/knowledge_graph/dir"
      }
    }
  }
}

快速使用指南

项目结构

提示文件位于 /src/rules/prompts 目录。请将这些文件复制到游标，并将其添加为代理模式的默认规则（请参阅 光标规则配置):

.cursor/
  └── rules/
      └── graph-query.mdc    # Knowledge graph query prompt file

使用代理模式

在Cursor中使用Agent模式时，您可以通过以下方式触发知识图查询：

  1. 类型 /ck 编辑器中的命令
  2. Agent将自动调用中定义的提示 @graph-query.mdc
  3. 提示将：
    • 分析当前上下文
    • 查询相关知识图节点
    • 生成摘要内容
    • 将查询结果集成到对话中

其他规则

该项目还包括生成手绘风格图形和Markdown文档作为知识图资源的提示。由于Cursor不支持MCP标准的提示，因此该项目使用工具来获取这些规则。您还可以将它们集成到如上所述的Cursor规则中，并将其修改为您所需的样式，以便在Cursor Agent模式下使用。

刀具清单

图形管理

  1. create_graph

    • 创建新的知识图谱
    • 参数：
      • name （string）：图形名称
      • description （字符串，可选）：图形描述
      • type （字符串）：图形类型（拓扑/时间线/变更日志/需求/kb/本体）

  2. list_graphs

    • 列出所有知识图表
    • 参数：
      • status （字符串，可选）：按状态筛选（草稿/已发布/已存档）
      • type （字符串，可选）：按类型筛选

  3. publish_graph

    • 发布知识图谱
    • 参数：
      • graphId （字符串）：图形ID

节点管理

  1. add_node

    • 向图中添加节点
    • 参数：
      • graphId （字符串）：图形ID
      • type （string）：节点类型
      • name （string）：节点名称
      • description （字符串，可选）：节点描述
      • filePath （字符串，可选）：关联的文件路径
      • metadata （对象，可选）：节点元数据

  2. update_node

    • 更新节点信息
    • 参数：
      • graphId （字符串）：图形ID
      • nodeId （字符串）：节点ID
      • name （字符串，可选）：新节点名称
      • description （字符串，可选）：新节点描述
      • filePath （字符串，可选）：新文件路径
      • metadata （对象，可选）：新元数据

  3. delete_node

    • 删除节点
    • 参数：
      • graphId （字符串）：图形ID
      • nodeId （字符串）：节点ID
      • confirmDelete （boolean）：删除确认

  4. get_node_details

    • 获取详细的节点信息
    • 参数：
      • graphId （字符串）：图形ID
      • nodeId （字符串）：节点ID

边缘管理

  1. add_edge

    • 添加边
    • 参数：
      • graphId （字符串）：图形ID
      • type （string）：边缘类型
      • sourceId （字符串）：源节点ID
      • targetId （string）：目标节点ID
      • label （字符串，可选）：边缘标签
      • weight （数量，可选）：边缘重量
      • metadata （对象，可选）：边缘元数据

  2. update_edge

    • 更新边缘信息
    • 参数：
      • graphId （字符串）：图形ID
      • edgeId （字符串）：边缘ID
      • label （字符串，可选）：新边标签
      • weight （数量，可选）：新边缘重量
      • metadata （对象，可选）：新元数据

  3. delete_edge

    • 删除边
    • 参数：
      • graphId （字符串）：图形ID
      • edgeId （字符串）：边缘ID
      • confirmDelete （boolean）：删除确认

资源管理

  1. get_creation_guidelines

    • 获取资源创建指南
    • 参数：
      • type （string）：指南类型（svg/markdown/all）

  2. save_resource

    • 保存资源
    • 参数：
      • graphId （字符串）：图形ID
      • nodeId （字符串，可选）：关联的节点ID
      • resourceType （string）：资源类型（svg/markdown）
      • title （string）：资源标题
      • description （字符串，可选）：资源描述
      • content （string）：资源内容

  3. update_resource

    • 更新资源信息
    • 参数：
      • graphId （字符串）：图形ID
      • resourceId （string）：资源ID
      • name （字符串，可选）：新资源名称
      • title （字符串，可选）：新资源标题
      • description （字符串，可选）：新资源描述

  4. delete_resource

    • 删除资源
    • 参数：
      • graphId （字符串）：图形ID
      • resourceId （string）：资源ID
      • confirmDelete （boolean）：删除确认

  5. unlink_resource

    • 从节点取消资源链接
    • 参数：
      • graphId （字符串）：图形ID
      • nodeId （字符串）：节点ID
      • resourceId （string）：资源ID

发展

# Install dependencies
pnpm install

# Development mode
pnpm dev

# Build project
pnpm build

# Run tests
pnpm test

# Code check
pnpm lint

错误处理

该服务使用标准错误处理机制。所有错误都记录到 md/error_log.txt 文件，包括时间戳、错误消息和堆栈跟踪。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP