Grafeo MCP

   

grafeo mcp

暴露的MCP服务器 GrafeoDB 的 -嵌入式图形数据库-通过 模型上下文协议.

一次安装，零基础设施。MCP服务器 *是* 数据库。

特性

• 23工具 -图CRUD、GQL查询、批量导入、全文搜索、向量搜索、MMR、混合检索、PageRank、Dijkstra、Louvain等
• 3资源 - graph://schema, graph://stats, graph://nodes/{id}
• 4个工作流提示 -通过探索、知识提取、图分析和相似性搜索来引导代理
• GQL与Cypher自动归一化 -接受过Cypher语法训练的代理可以开箱即用
• 架构优先 -代理在查询之前发现图结构
• 令牌感知 -所有工具都有 limit params和截断大型结果
• 嵌入式 -无需管理单独的数据库服务器

快速入门

# Install
uv tool install grafeo-mcp

# Or with pip
pip install grafeo-mcp

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "grafeo": {
      "command": "grafeo-mcp",
      "env": {
        "GRAFEO_DB_PATH": "/path/to/your/graph.db"
      }
    }
  }
}

克劳德代码

添加 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "grafeo": {
      "command": "grafeo-mcp",
      "env": {
        "GRAFEO_DB_PATH": "./graph.db"
      }
    }
  }
}

VS代码/副本

添加 .vscode/mcp.json:

{
  "servers": {
    "grafeo": {
      "command": "grafeo-mcp",
      "env": {
        "GRAFEO_DB_PATH": "${workspaceFolder}/graph.db"
      }
    }
  }
}

HTTP传输

对于远程或多客户端设置：

grafeo-mcp streamable-http

环境变量

工具

查询

CRUD和遍历图

批量导入

全文检索

向量搜索

图的算法

资源

提示

什么时候用什么工具？

批处理引用语法

这 batch_import 该工具允许边引用在同一批中创建的节点 @N 符号，其中 N 是从零开始的指数进入 nodes 数组：

batch_import(
    nodes=[
        {"labels": ["Person"], "properties": {"name": "Alice"}},  # @0
        {"labels": ["Person"], "properties": {"name": "Bob"}},    # @1
    ],
    edges=[
        {"source_ref": "@0", "target_ref": "@1", "edge_type": "KNOWS"},
    ],
)

您还可以将批引用与现有节点ID混合使用： {"source_ref": "@0", "target_ref": 42, ...}.

密码正常化

这 execute_gql 该工具会自动将常见的Cypher语法规范化为GQL，这样接受过Cypher训练的代理就可以开箱即用。目前应用了以下转换：

Cypher和GQL之间共享的关键字（例如 MATCH, RETURN, WHERE, WITH, LIMIT, DETACH DELETE)通过不变。仅加密关键字，如 MERGE 或 OPTIONAL MATCH 是 不 支持，并将从查询引擎生成明确的错误消息。

发展

git clone https://github.com/GrafeoDB/grafeo-mcp
cd grafeo-mcp
uv sync
uv run pytest          # Run tests
uv run ruff check .    # Lint
uv run ruff format .   # Format
uv run ty check        # Type check

另见

• 涂鸦记忆 包括一个内置的MCP服务器(grafeo-memory-mcp)它包装了高级内存API-提取、协调、搜索、汇总。如果您需要AI内存管理而不是原始图形访问，请使用 uv add grafeo-memory[mcp].

许可证

阿帕奇-2.0