does-it-install?

← All servers

Neo4j GDS Agent

Neo4j Graph Data Science MCP server

io.github.neo4j-contrib/gds-agent · Repository · version 1.0.1 · 96 stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

uvx gds-agent

Needs credentials: NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.

Results by platform

Linux

needs credentials2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading pandas (11.7MiB)
Downloading graphdatascience (2.0MiB)
Downloading numpy (15.8MiB)
Downloading pyarrow (45.4MiB)
 Downloaded graphdatascience
 Downloaded pyarrow
 Downloaded numpy
 Downloaded pandas
Installed 54 packages in 146ms
2026-08-16 03:01:41,268 - mcp_server_neo4j_gds - INFO - Starting MCP Server for DOES_IT_INSTALL_PLACEHOLDER with username DOES_IT_INSTALL_PLACEHOLDER
2026-08-16 03:01:41,268 - mcp_server_neo4j_gds - ERROR - Failed to connect to Neo4j database: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]
Traceback (most recent call last):
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/bin/gds-agent", line 12, in <module>
    sys.exit(main())
             ~~~~^^
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/mcp_server_neo4j_gds/__init__.py", line 103, in main
    asyncio.run(
    ~~~~~~~~~~~^
        server.main(
        ^^^^^^^^^^^^
    ...<8 lines>...
        )
        ^
    )
    ^
  File "/home/runner/.local/share/uv/python/cpython-3.13.15-linux-x86_64-gnu/lib/python3.13/asyncio/runners.py", line 196, in run
    return runner.run(main)
           ~~~~~~~~~~^^^^^^
  File "/home/runner/.local/share/uv/python/cpython-3.13.15-linux-x86_64-gnu/lib/python3.13/asyncio/runners.py", line 119, in run
    return self._loop.run_until_complete(task)
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^
  File "/home/runner/.local/share/uv/python/cpython-3.13.15-linux-x86_64-gnu/lib/python3.13/asyncio/base_events.py", line 726, in run_until_complete
    return future.result()
           ~~~~~~~~~~~~~^^
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/mcp_server_neo4j_gds/server.py", line 563, in main
    server, session_manager, base_gds = create_mcp_server(
                                        ~~~~~~~~~~~~~~~~~^
        db_url, username, password, database
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/mcp_server_neo4j_gds/server.py", line 161, in create_mcp_server
    base_gds = create_base_gds(db_url, username, password, database)
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/mcp_server_neo4j_gds/server.py", line 95, in create_base_gds
    return GraphDataScience(db_url, auth=(username, password), aura_ds=False)
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/graphdatascience/graph_data_science.py", line 100, in __init__
    neo4j_query_runner = Neo4jQueryRunner.create_for_db(
        endpoint, db_auth, aura_ds, database, bookmarks, show_progress
    )
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/graphdatascience/query_runner/neo4j_query_runner.py", line 54, in create_for_db
    driver = neo4j.GraphDatabase.driver(endpoint, auth=auth, database=database, **config)
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/neo4j/_sync/driver.py", line 193, in driver
    driver_type, security_type, parsed = parse_neo4j_uri(uri)
                                         ~~~~~~~~~~~~~~~^^^^^
  File "/home/runner/.cache/uv/archive-v0/Fx99CPfrlu6SluJd/lib/python3.13/site-packages/neo4j/_api.py", line 103, in parse_neo4j_uri
    raise ConfigurationError(
    ...<4 lines>...
    )
neo4j.exceptions.ConfigurationError: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]

macOS

needs credentials2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading pyarrow (32.7MiB)
Downloading numpy (4.9MiB)
Downloading pandas (10.3MiB)
Downloading graphdatascience (2.0MiB)
 Downloaded graphdatascience
 Downloaded numpy
 Downloaded pyarrow
 Downloaded pandas
Installed 54 packages in 379ms
2026-08-16 03:04:54,114 - mcp_server_neo4j_gds - INFO - Starting MCP Server for DOES_IT_INSTALL_PLACEHOLDER with username DOES_IT_INSTALL_PLACEHOLDER
2026-08-16 03:04:54,114 - mcp_server_neo4j_gds - ERROR - Failed to connect to Neo4j database: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]
Traceback (most recent call last):
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/bin/gds-agent", line 12, in <module>
    sys.exit(main())
             ~~~~^^
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/mcp_server_neo4j_gds/__init__.py", line 103, in main
    asyncio.run(
    ~~~~~~~~~~~^
        server.main(
        ^^^^^^^^^^^^
    ...<8 lines>...
        )
        ^
    )
    ^
  File "/opt/homebrew/Cellar/[email protected]/3.14.6/Frameworks/Python.framework/Versions/3.14/lib/python3.14/asyncio/runners.py", line 205, in run
    return runner.run(main)
           ~~~~~~~~~~^^^^^^
  File "/opt/homebrew/Cellar/[email protected]/3.14.6/Frameworks/Python.framework/Versions/3.14/lib/python3.14/asyncio/runners.py", line 128, in run
    return self._loop.run_until_complete(task)
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^
  File "/opt/homebrew/Cellar/[email protected]/3.14.6/Frameworks/Python.framework/Versions/3.14/lib/python3.14/asyncio/base_events.py", line 719, in run_until_complete
    return future.result()
           ~~~~~~~~~~~~~^^
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/mcp_server_neo4j_gds/server.py", line 563, in main
    server, session_manager, base_gds = create_mcp_server(
                                        ~~~~~~~~~~~~~~~~~^
        db_url, username, password, database
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/mcp_server_neo4j_gds/server.py", line 161, in create_mcp_server
    base_gds = create_base_gds(db_url, username, password, database)
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/mcp_server_neo4j_gds/server.py", line 95, in create_base_gds
    return GraphDataScience(db_url, auth=(username, password), aura_ds=False)
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/graphdatascience/graph_data_science.py", line 100, in __init__
    neo4j_query_runner = Neo4jQueryRunner.create_for_db(
        endpoint, db_auth, aura_ds, database, bookmarks, show_progress
    )
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/graphdatascience/query_runner/neo4j_query_runner.py", line 54, in create_for_db
    driver = neo4j.GraphDatabase.driver(endpoint, auth=auth, database=database, **config)
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/neo4j/_sync/driver.py", line 193, in driver
    driver_type, security_type, parsed = parse_neo4j_uri(uri)
                                         ~~~~~~~~~~~~~~~^^^^^
  File "/Users/runner/.cache/uv/archive-v0/LEJLsDN8H3y8iveE/lib/python3.14/site-packages/neo4j/_api.py", line 103, in parse_neo4j_uri
    raise ConfigurationError(
    ...<4 lines>...
    )
neo4j.exceptions.ConfigurationError: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]

Windows

needs credentials2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading pandas (10.5MiB)
Downloading numpy (12.2MiB)
Downloading graphdatascience (2.0MiB)
Downloading pyarrow (26.3MiB)
 Downloaded graphdatascience
 Downloaded numpy
 Downloaded pyarrow
 Downloaded pandas
Installed 56 packages in 29.11s
2026-08-16 04:36:59,548 - mcp_server_neo4j_gds - INFO - Starting MCP Server for DOES_IT_INSTALL_PLACEHOLDER with username DOES_IT_INSTALL_PLACEHOLDER
2026-08-16 04:36:59,548 - mcp_server_neo4j_gds - ERROR - Failed to connect to Neo4j database: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Scripts\gds-agent.exe\__main__.py", line 10, in <module>
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\mcp_server_neo4j_gds\__init__.py", line 103, in main
    asyncio.run(
  File "C:\hostedtoolcache\windows\Python\3.12.10\x64\Lib\asyncio\runners.py", line 195, in run
    return runner.run(main)
           ^^^^^^^^^^^^^^^^
  File "C:\hostedtoolcache\windows\Python\3.12.10\x64\Lib\asyncio\runners.py", line 118, in run
    return self._loop.run_until_complete(task)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\hostedtoolcache\windows\Python\3.12.10\x64\Lib\asyncio\base_events.py", line 691, in run_until_complete
    return future.result()
           ^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\mcp_server_neo4j_gds\server.py", line 563, in main
    server, session_manager, base_gds = create_mcp_server(
                                        ^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\mcp_server_neo4j_gds\server.py", line 161, in create_mcp_server
    base_gds = create_base_gds(db_url, username, password, database)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\mcp_server_neo4j_gds\server.py", line 95, in create_base_gds
    return GraphDataScience(db_url, auth=(username, password), aura_ds=False)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\graphdatascience\graph_data_science.py", line 100, in __init__
    neo4j_query_runner = Neo4jQueryRunner.create_for_db(
                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\graphdatascience\query_runner\neo4j_query_runner.py", line 54, in create_for_db
    driver = neo4j.GraphDatabase.driver(endpoint, auth=auth, database=database, **config)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\neo4j\_sync\driver.py", line 193, in driver
    driver_type, security_type, parsed = parse_neo4j_uri(uri)
                                         ^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\PG3AOqNITFKZBkEn\Lib\site-packages\neo4j\_api.py", line 103, in parse_neo4j_uri
    raise ConfigurationError(
neo4j.exceptions.ConfigurationError: URI scheme '' is not supported. Supported URI schemes are ['bolt', 'bolt+ssc', 'bolt+s', 'neo4j', 'neo4j+ssc', 'neo4j+s']. Examples: bolt://host[:port] or neo4j://host[:port][?routing_context]

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.neo4j-contrib__gds-agent.json)](https://doesitinstall.com/s/io.github.neo4j-contrib__gds-agent.html)