知识图谱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模式时，您可以通过以下方式触发知识图查询：
- 类型
/ck编辑器中的命令 - Agent将自动调用中定义的提示
@graph-query.mdc - 提示将：
- 分析当前上下文 - 查询相关知识图节点 - 生成摘要内容 - 将查询结果集成到对话中
其他规则
该项目还包括生成手绘风格图形和Markdown文档作为知识图资源的提示。由于Cursor不支持MCP标准的提示，因此该项目使用工具来获取这些规则。您还可以将它们集成到如上所述的Cursor规则中，并将其修改为您所需的样式，以便在Cursor Agent模式下使用。
刀具清单
图形管理
create_graph
- 创建新的知识图谱 - 参数： - name （string）：图形名称 - description （字符串，可选）：图形描述 - type （字符串）：图形类型（拓扑/时间线/变更日志/需求/kb/本体）
list_graphs
- 列出所有知识图表 - 参数： - status （字符串，可选）：按状态筛选（草稿/已发布/已存档） - type （字符串，可选）：按类型筛选
publish_graph
- 发布知识图谱 - 参数： - graphId （字符串）：图形ID
节点管理
add_node
- 向图中添加节点 - 参数： - graphId （字符串）：图形ID - type （string）：节点类型 - name （string）：节点名称 - description （字符串，可选）：节点描述 - filePath （字符串，可选）：关联的文件路径 - metadata （对象，可选）：节点元数据
update_node
- 更新节点信息 - 参数： - graphId （字符串）：图形ID - nodeId （字符串）：节点ID - name （字符串，可选）：新节点名称 - description （字符串，可选）：新节点描述 - filePath （字符串，可选）：新文件路径 - metadata （对象，可选）：新元数据
delete_node
- 删除节点 - 参数： - graphId （字符串）：图形ID - nodeId （字符串）：节点ID - confirmDelete （boolean）：删除确认
get_node_details
- 获取详细的节点信息 - 参数： - graphId （字符串）：图形ID - nodeId （字符串）：节点ID
边缘管理
add_edge
- 添加边 - 参数： - graphId （字符串）：图形ID - type （string）：边缘类型 - sourceId （字符串）：源节点ID - targetId （string）：目标节点ID - label （字符串，可选）：边缘标签 - weight （数量，可选）：边缘重量 - metadata （对象，可选）：边缘元数据
update_edge
- 更新边缘信息 - 参数： - graphId （字符串）：图形ID - edgeId （字符串）：边缘ID - label （字符串，可选）：新边标签 - weight （数量，可选）：新边缘重量 - metadata （对象，可选）：新元数据
delete_edge
- 删除边 - 参数： - graphId （字符串）：图形ID - edgeId （字符串）：边缘ID - confirmDelete （boolean）：删除确认
资源管理
get_creation_guidelines
- 获取资源创建指南 - 参数： - type （string）：指南类型（svg/markdown/all）
save_resource
- 保存资源 - 参数： - graphId （字符串）：图形ID - nodeId （字符串，可选）：关联的节点ID - resourceType （string）：资源类型（svg/markdown） - title （string）：资源标题 - description （字符串，可选）：资源描述 - content （string）：资源内容
update_resource
- 更新资源信息 - 参数： - graphId （字符串）：图形ID - resourceId （string）：资源ID - name （字符串，可选）：新资源名称 - title （字符串，可选）：新资源标题 - description （字符串，可选）：新资源描述
delete_resource
- 删除资源 - 参数： - graphId （字符串）：图形ID - resourceId （string）：资源ID - confirmDelete （boolean）：删除确认
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许可证获得许可-请参阅 许可证 文件以获取详细信息。