项目简介

本项目是一个符合 Model Context Protocol (MCP) 标准的知识图谱服务器，旨在为AI应用提供结构化的知识存储和管理能力。通过本服务，您可以创建和管理多种类型的知识图谱，例如拓扑结构图、时间线图谱、变更日志图谱、需求文档图谱、知识库图谱和本体论图谱。服务提供了丰富的工具接口，支持知识图谱的增删改查、资源关联以及可视化等功能，可以与Cursor、Claude等MCP客户端无缝集成，提升AI应用处理上下文信息的能力。

主要功能点

多类型图谱支持：支持创建和管理多种类型的知识图谱，满足不同场景下的知识表示需求。
全面的错误处理：提供清晰的错误信息和处理建议，帮助用户快速定位和解决问题。
资源管理：支持SVG和Markdown等资源与知识图谱的关联和管理，增强知识图谱的可视化和文档能力。
版本状态管理：支持草稿、发布和归档等多种状态管理，方便知识图谱的生命周期管理。
丰富的工具集：提供完善的API工具，涵盖图谱、节点、边和资源的管理操作。

安装步骤

安装Node.js和pnpm：确保您的环境中已安装 Node.js (>= 16.0.0) 和 pnpm (>= 7.0.0)。
创建知识图谱数据目录：在您的用户目录下创建一个用于存储知识图谱数据的目录，例如 '~/knowledge_graph'。
```
mkdir ~/knowledge_graph
```

服务器配置

为了让MCP客户端（如Cursor或Claude）能够连接到知识图谱MCP服务器，您需要在客户端的配置文件中添加服务器配置信息。以下分别是在Cursor和Claude Desktop中配置的说明：

Cursor 配置

打开Cursor的配置文件（通常是 'settings.json' 或通过 Cursor 设置界面编辑），在 'mcpServers' 字段下添加 'knowledge-graph' 服务器配置。配置内容应包含以下信息：

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

'server name' (服务器名称): 'knowledge-graph' (客户端通过此名称引用服务器)
'command' (启动命令): 'npx' (Node Package Execute，用于执行npm包)
'args' (命令参数): '["-y", "@aiuluna/knowledge-graph-mcp"]' (指定要执行的npm包，'-y' 参数表示自动确认安装包)
'env' (环境变量): '{"KNOWLEDGE_GRAPH_DIR": "/path/to/your/knowledge_graph/dir"}' (设置 'KNOWLEDGE_GRAPH_DIR' 环境变量，指向您创建的知识图谱数据目录，请替换为您的实际目录路径)

Claude Desktop 配置

打开 'claude_desktop_config.json' 文件，在 'mcpServers' 字段下添加 'knowledge-graph' 服务器配置。配置内容与Cursor类似：

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

配置项含义与Cursor配置相同，请确保 'KNOWLEDGE_GRAPH_DIR' 指向正确的知识图谱数据目录。

基本使用方法

配置完成后，在Cursor或Claude等MCP客户端中，您可以通过调用预设的工具来操作知识图谱。例如，在Cursor中使用Agent模式时，可以通过命令 '/ck' 触发知识图谱查询，Agent会自动调用预定义的 Prompt 和工具与知识图谱服务器交互，分析上下文并返回相关信息。

您还可以根据项目提供的 Prompt 示例（位于仓库的 '/src/rules/prompts' 目录下），将其添加到Cursor的规则配置中，以便在Agent模式下更方便地使用知识图谱功能。具体操作方法请参考仓库的 'Prompt Usage Guide' 部分和 Cursor 规则配置文档。

注意：

请确保将配置中的 '/path/to/your/knowledge_graph/dir' 替换为您实际创建的知识图谱数据目录路径。
您可以根据需要指定特定的 '@aiuluna/knowledge-graph-mcp' 版本号，例如 '@0.0.1'。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息