does-it-install?

← All servers

io.github.neo4j-contrib/mcp-neo4j-cypher

A simple Neo4j MCP server that allows you to run Cypher queries against a Neo4j database.

io.github.neo4j-contrib/mcp-neo4j-cypher · Repository · version 1.0.0 · 979 stars · listed from registry

Install

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

uvx mcp-neo4j-cypher

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) ---
Installed 76 packages in 85ms
Warning: No Neo4j database provided. Using default: neo4j
Warning: No transport type provided. Using default: stdio
Traceback (most recent call last):
  File "/home/runner/.cache/uv/archive-v0/I3WRL6VggPpTsHj6/bin/mcp-neo4j-cypher", line 12, in <module>
    sys.exit(main())
             ^^^^^^
  File "/home/runner/.cache/uv/archive-v0/I3WRL6VggPpTsHj6/lib/python3.12/site-packages/mcp_neo4j_cypher/__init__.py", line 55, in main
    asyncio.run(server.main(**config))
  File "/usr/lib/python3.12/asyncio/runners.py", line 194, in run
    return runner.run(main)
           ^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/asyncio/runners.py", line 118, in run
    return self._loop.run_until_complete(task)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/asyncio/base_events.py", line 687, in run_until_complete
    return future.result()
           ^^^^^^^^^^^^^^^
  File "/home/runner/.cache/uv/archive-v0/I3WRL6VggPpTsHj6/lib/python3.12/site-packages/mcp_neo4j_cypher/server.py", line 293, in main
    neo4j_driver = AsyncGraphDatabase.driver(
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.cache/uv/archive-v0/I3WRL6VggPpTsHj6/lib/python3.12/site-packages/neo4j/_async/driver.py", line 194, in driver
    driver_type, security_type, parsed = parse_neo4j_uri(uri)
                                         ^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.cache/uv/archive-v0/I3WRL6VggPpTsHj6/lib/python3.12/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]

macOS

needs credentials2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Installed 74 packages in 274ms
Warning: No Neo4j database provided. Using default: neo4j
Warning: No transport type provided. Using default: stdio
Traceback (most recent call last):
  File "/Users/runner/.cache/uv/archive-v0/lXKJbrfAzM9ShTGe/bin/mcp-neo4j-cypher", line 12, in <module>
    sys.exit(main())
             ~~~~^^
  File "/Users/runner/.cache/uv/archive-v0/lXKJbrfAzM9ShTGe/lib/python3.14/site-packages/mcp_neo4j_cypher/__init__.py", line 55, in main
    asyncio.run(server.main(**config))
    ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^
  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/lXKJbrfAzM9ShTGe/lib/python3.14/site-packages/mcp_neo4j_cypher/server.py", line 293, in main
    neo4j_driver = AsyncGraphDatabase.driver(
        db_url,
    ...<3 lines>...
        ),
    )
  File "/Users/runner/.cache/uv/archive-v0/lXKJbrfAzM9ShTGe/lib/python3.14/site-packages/neo4j/_async/driver.py", line 194, in driver
    driver_type, security_type, parsed = parse_neo4j_uri(uri)
                                         ~~~~~~~~~~~~~~~^^^^^
  File "/Users/runner/.cache/uv/archive-v0/lXKJbrfAzM9ShTGe/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) ---
Installed 77 packages in 12.78s
Warning: No Neo4j database provided. Using default: neo4j
Warning: No transport type provided. Using default: stdio
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\fWc-9_7YC2dJAL-G\Scripts\mcp-neo4j-cypher.exe\__main__.py", line 10, in <module>
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\fWc-9_7YC2dJAL-G\Lib\site-packages\mcp_neo4j_cypher\__init__.py", line 55, in main
    asyncio.run(server.main(**config))
  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\fWc-9_7YC2dJAL-G\Lib\site-packages\mcp_neo4j_cypher\server.py", line 293, in main
    neo4j_driver = AsyncGraphDatabase.driver(
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\fWc-9_7YC2dJAL-G\Lib\site-packages\neo4j\_async\driver.py", line 194, in driver
    driver_type, security_type, parsed = parse_neo4j_uri(uri)
                                         ^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\fWc-9_7YC2dJAL-G\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__mcp-neo4j-cypher.json)](https://doesitinstall.com/s/io.github.neo4j-contrib__mcp-neo4j-cypher.html)