GDS代理
目前，无论是大型语言模型（LLMs）还是现有的任何工具（如MCP服务器），都无法对图结构进行复杂的推理。
这个MCP服务器包含了来自Neo4j图数据科学（GDS）库的工具，使您能够运行所有常见的图算法。
一旦服务器运行起来，您就可以 关于你的Neo4j图数据库，有任何图表相关的问题都可以问我 并获取答案。配备有GDS代理的大语言模型（LLMs）能够在您Neo4j数据库中的图上决定并准确执行适当的参数化图算法。
一个例子是，当一个配备有GDS（全球分销系统）代理的大型语言模型（LLM）能够选择最短路径和Yen算法来回答我关于旅行计划的问题时： gds-agent-example
目录
对于用户
对于开发者
使用GDS代理
如果你有 uvx 已安装在您的（配置/设置中）添加以下配置 claude_desktop_config.json
{
"mcpServers": {
"neo4j-gds": {
"command": "/opt/homebrew/bin/uvx",
"args": [ "gds-agent" ],
"env": {
"NEO4J_URI": "bolt://localhost:7687",
"NEO4J_USERNAME": "neo4j",
"NEO4J_PASSWORD": ""
}
}
}
}将命令替换为你的（命令/指令） uvx 位置。通过运行来查找 which uvx 在命令行中。 替换 NEOJ_URI， NEO4J_USERNAME， NEO4J_PASSWORD 使用您的数据库登录详细信息。您也可以选择性地指定 NEO4J_DATABASE。
示例数据集
要加载伦敦地铁示例数据集：
- 克隆并复制仓库
- 在您的Python环境中安装必要的包，使用
pip install -r requirements.txt - 安装带有GDS插件的Neo4j数据库：
从（指定位置）下载Neo4j Desktop Neo4j 下载中心 从Neo4j Desktop安装GDS插件 创建一个新的数据库并启动它
- 在 .env 文件中填入必要的凭据：
NEO4J_URI=bolt://localhost:7687 # or your database URI
NEO4J_USERNAME=neo4j # or your db username
NEO4J_PASSWORD=your_password- 使用以下命令加载伦敦地铁数据集：
python import_data.py --undirected连接到您的数据库并查询图数据 Neo4j 工作区， 你应该看到： London Underground Graph
启动开发服务器
- 当在……里面时
/mcp_server目录，运行uv sync --dev并运行uv run gds-agent启动独立运行的MCP服务器，或运行claude使用代理启动 claude-cli。
如何做出贡献
从你克隆的仓库的分支向这个仓库的主分支发起一个拉取请求，例如： mygithubid:add-new-algo -> neo4j-contrib:main。
GitHub Action 中的 CI 构建要求所有代码风格检查和测试都必须通过。
要在本地运行并修复代码风格检查，请在 /mcp_server 目录，运行：
uv sync --dev设置Python环境。然后，
uv run pytest tests -v -s
uv run ruff check
uv run ruff format进行所有测试并修复代码风格问题。
功能请求和错误报告
如需报告错误或提出新功能请求，请提交一个问题。 如果这是一个错误，请包含完整的堆栈跟踪和错误信息。 如有相关日志，请附上 mcp_server_neo4j_gds.log这个文件位于……内部 /mcp_server/src_mcp_server_neo4j_gds 如果GDS代理是从源代码运行的，则为目录，或者位于Claude的日志路径内（例如 /Library/Logs/Claude （针对Mac上的Claude Desktop）。如果可能，请包含相关的最小数据集，以便能够重现该问题。
额外资源
GDS代理可以与其他MCP服务器一起使用，例如那些提供额外Neo4j工具的服务器：https://github.com/neo4j-contrib/mcp-neo4j