neo4j-contrib/mcp-neo4j releases

v0.6.0

Fixed

• Fix startup ImportError caused by pydocket importing FakeConnection from fakeredis>=2.27 — cap fastmcp<2.14 to exclude the pydocket transitive dependency
• Fix TypeError: str expected, not int in integration tests caused by testcontainers returning an int from get_exposed_port()

Changed

• Update _is_write_query to use EXPLAIN query instead of regex check

What's Changed

• refactor: standardize error handling and raise ToolError per MCP policy by @ChinmayPande48 in https://github.com/neo4j-contrib/mcp-neo4j/pull/275
• update read only check using EXPLAIN by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/281
• 280 importerror cannot import name fakeconnection from fakeredisaioredis on startup by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/282
• cypher - prep v0.6.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/283

New Contributors

• @ChinmayPande48 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/275

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-gemini-ext-v1.0.1...mcp-neo4j-cypher-v0.6.0

What's Changed

• chore: use extension settings for Gemini CLI extension by @jackwotherspoon in https://github.com/neo4j-contrib/mcp-neo4j/pull/278

New Contributors

• @jackwotherspoon made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/278

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.8...mcp-gemini-ext-v1.0.1

Changed

• Security upgrade python from 3.11-slim to 3.13.8-slim
• Change default MCP server endpoint from /api/mcp/ to /mcp/
• Lock FastMCP version to <3.x

New Contributors

• @bryankthompson made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/262
• @AndyHeap-NeoTech made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/200
• @robsdedude made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/203
• @Amitk003 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/266

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.2...mcp-neo4j-memory-v0.4.5

Changed

• Docker security upgrade python from 3.11-slim to 3.13.8-slim
• Lock FastMCP version to <3.x

New Contributors

• @bryankthompson made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/262
• @AndyHeap-NeoTech made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/200
• @robsdedude made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/203
• @Amitk003 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/266

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.2...mcp-neo4j-aura-manager-v0.4.8

Changed

• Security upgrade python from 3.12-slim to 3.13.8-slim
• Update default MCP server endpoint from /api/mcp/ to /mcp/
• Lock FastMCP version to <3.x

New Contributors

• @bryankthompson made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/262
• @AndyHeap-NeoTech made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/200
• @robsdedude made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/203
• @Amitk003 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/266

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.2...mcp-neo4j-cypher-v0.5.3

Fixed

• Fixed bug in f-string formatting with Pydantic model export in Python v < 3.12
• Fixed bug in the data modeling Github action that didn't actually test different Python versions due to not specifying the version when executing uv commands.
• Fix Github action to install dev dependencies correctly with uv sync

Changed

• Update pyproject.toml to declare dev dependencies correctly (previously using deprecated method)

What's Changed

• Update data modeling server.json by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/257
• all - bump mcp registry schema versions to 2025-12-11 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/258
• data modeling - fix f-string bug and github actions bug by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/260
• data modeling - prep v0.8.2 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/261

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.1...mcp-neo4j-data-modeling-v0.8.2

Fixed

• Shorten tool name export_to_neo4j_python_graphrag_package_schema to export_to_neo4j_graphrag_pkg_schema to be under 60 characters including the default server name.
• Shorten tool name load_from_neo4j_python_graphrag_package_schema to load_from_neo4j_graphrag_pkg_schema to be under 60 characters including the default server name.

Added

• Update README to include new tools and optional return_validated argument to validation tools

What's Changed

• data modeling - short tool names by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/251
• data modeling - update readme by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/252
• Update README.md with Official Neo4j MCP Info by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/253
• data modeling - prep v0.8.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/254
• cypher and data modeling - update workflows to execute serially by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/255

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.8.0...mcp-neo4j-data-modeling-v0.8.1

v0.8.0

Fixed

• Remove stateless_http flag on MCP server constructor and move to the appropriate run_... function for http and sse transport. The constructor flag is deprecated by FastMCP.
• Removed dependencies=... from server constructor. This was removed from FastMCP.

Changed

• Make node corners rounded for Mermaid visualization

Added

• Add methods to export schema as string representations of Pydantic models for Node, Relationship and DataModel
• Add tool that exports data model as a string representation of a Python file containing imports and Pydantic models
• Add methods to import and export as Neo4j GraphRAG Python Package schema JSON for Node, Relationship and DataModel
• Add tools that import and export data model as Neo4j GraphRAG Python Package schema JSON
• Add description field to Node and Relationship classes
• Add docstring to generated Pydantic nodes and relationships based on description field

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.7...mcp-neo4j-data-modeling-v0.8.0

Fixed

• Fix bug in Dockerfile where build would fail due to LABEL statement coming before FROM statement
• Removed dependencies=... from server constructor. This was removed from FastMCP.

What's Changed

• cypher - prep v0.5.2 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/249

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.4.3...mcp-neo4j-cypher-v0.5.2

Fixed

• Removed dependencies=... from server constructor. This was removed from FastMCP.

What's Changed

• aura manager - prep v0.4.7 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/248

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.4.3...mcp-neo4j-aura-manager-v0.4.7

Fixed

• Removed dependencies=... from server constructor. This was removed from FastMCP.

What's Changed

• update memory server by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/246
• memory - prep v0.4.4 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/247
• aura manager - prep v0.4.7 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/248
• cypher - prep v0.5.2 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/249
• data modeling - prep v0.8.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/250

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.4.3...mcp-neo4j-memory-v0.4.4

Fixed

• Fix bug in Dockerfile where build would fail due to LABEL statement coming before FROM statement

Changed

• Updated Entity.type and Relation.relationType Pydantic model fields to have regex checks.

What's Changed

• memory - add regex checks to Entity and Relation fields by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/238
• memory - prep v0.4.3 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/243

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.7.0...mcp-neo4j-memory-v0.4.3

Fixed

• Fix bug in Dockerfile where build would fail due to LABEL statement coming before FROM statement

Changed

• Tools that received Pydantic objects as arguments now also accept JSON strings as input. This is for client applications that send JSON strings instead of objects for tool arguments. This is a workaround for client applications that don't adhere to the defined tool schemas and will be removed in the future once it is not needed.

Added

• Added JSON string parsing utils function. This is for client applications that send JSON strings instead of objects for tool arguments. This is a workaround for client applications that don't adhere to the defined tool schemas and will be removed in the future once it is not needed.

What's Changed

• All - patch dockerfiles by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/230
• Data modeling - allow JSON object and String as tool input by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/231
• Data modeling prep v0.7.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/232

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.6...mcp-neo4j-data-modeling-v0.7.0

Fixed

• Fix bug in Dockerfile where build would fail due to LABEL statement coming before FROM statement

Added

• Add NEO4J_MCP_SERVER_STATELESS environment variable and --stateless cli flag to configure stateless http deployment options when using http or sse transport

What's Changed

• aura manager - add stateless flag by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/227
• aura manager - prep v0.4.6 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/228

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.4.2...mcp-neo4j-aura-manager-v0.4.6

What's Changed

• Memory - add mcp registry config by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/225
• memory - prep v0.4.2 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/226

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.5...mcp-neo4j-memory-v0.4.2

What's Changed

• aura manager - patch mcp registry config by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/223
• aura manager - prep v0.4.5 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/224

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.4...mcp-neo4j-aura-manager-v0.4.5

What's Changed

• aura manager - add config to deploy to mcp registry by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/221
• aura manager - prep v0.4.4 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/222

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.5.1...mcp-neo4j-aura-manager-v0.4.4

What's Changed

• cypher - add mcp registry config by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/219
• cypher - prep v0.5.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/220

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.6.1...mcp-neo4j-cypher-v0.5.1

What's Changed

• data modeling - add to github registry by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/214
• Data modeling add to GitHub registry - fix by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/215
• Data modeling add to GitHub registry by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/216
• Data modeling add to GitHub registry by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/217
• data modeling - prep v0.6.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/218

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.6.0...mcp-neo4j-data-modeling-v0.6.1

Added

• Add import and export methods to DataModel for turtle OWL strings
• Add MCP tools for loading and exporting turtle OWL files

What's Changed

• data modeling - add turtle owl import / export tools by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/210
• data modeling - prep v0.6.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/213

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.5.0...mcp-neo4j-data-modeling-v0.6.0

Added

• Add NEO4J_SCHEMA_SAMPLE_SIZE env variable and schema-sample-size cli argument to configure the get_neo4j_schema sample size
• Update write query detection to include INSERT in regex check

What's Changed

• Fix write query detection to recognise INSERT. by @michael-simons in https://github.com/neo4j-contrib/mcp-neo4j/pull/205
• Adding a NEO4J_SAMPLE parameter to enable control of apoc.meta.schema sample size by @mimomenome in https://github.com/neo4j-contrib/mcp-neo4j/pull/211
• cypher - prep v0.5.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/212

New Contributors

• @pedroleitao-neo4j made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/198
• @michael-simons made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/205
• @mimomenome made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/211

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.3...mcp-neo4j-cypher-v0.5.0

Added

• Add namespacing support for multi-tenant deployments with --namespace CLI argument and NEO4J_NAMESPACE environment variable

What's Changed

• data modeling - prep v0.5.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/196
• aura manager - prep v0.4.3 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/197

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.4.1...mcp-neo4j-data-modeling-v0.5.1

Added

• Add namespacing support for multi-tenant deployments with --namespace CLI argument and NEO4J_NAMESPACE environment variable

What's Changed

• aura manager - prep v0.4.3 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/197

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.4.1...mcp-neo4j-aura-manager-v0.4.3

What's Changed

• Mcp 114/namespacing memory by @rfrneo4j in https://github.com/neo4j-contrib/mcp-neo4j/pull/183
• Enhance MCP tool schemas and documentation for better LLM integration by @aperepel in https://github.com/neo4j-contrib/mcp-neo4j/pull/143
• memory - prep v0.4.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/195

New Contributors

• @benofben made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/188
• @aperepel made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/143

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.5.0...mcp-neo4j-memory-v0.4.1

What's Changed

• Introduce Read only mode for MCP Cypher by @tomasonjo in https://github.com/neo4j-contrib/mcp-neo4j/pull/184
• cypher - prep v0.4.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/194

New Contributors

• @benofben made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/188
• @aperepel made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/143

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.5.0...mcp-neo4j-cypher-v0.4.1

Fixed

• Fix bug where MCP server could only be deployed with stdio transport

Changed

• Update README with link to data modeling demo repo and workflow image
• Update Dockerfile for Docker Hub deployment
• Change default transport to stdio in Dockerfile

Added

• Add security middleware (CORS and TrustedHost) for HTTP and SSE transports
• Add CLI support for --allow-origins and --allowed-hosts configuration
• Add environment variable for NEO4J_MCP_SERVER_ALLOW_ORIGINS and NEO4J_MCP_SERVER_ALLOWED_HOSTS configuration
• Add detailed logging for configuration parameter parsing

What's Changed

• data-modeling - prep v0.5.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/180

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.2...mcp-neo4j-data-modeling-v0.5.0

Fixed

• fix bug where config logging wasn't being used

Changed

• Use stateless_http=False when using http or sse transport to be consistent with previous configuration

What's Changed

• fix config parsing, remote deployments use stateful http to be consis… by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/178
• Aura manager prep v0.4.2 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/179

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.1...mcp-neo4j-aura-manager-v0.4.2

Fixed

• f-string bug in utils.py patched for earlier Python versions

What's Changed

• aura-manager - update PR tests, update utils bug by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/174
• aura-manager - bump versions, update changelog by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/175

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.4.0...mcp-neo4j-aura-manager-v0.4.1

Changed

• Change default transport in Dockerfile to stdio
• Split client, service and MCP classes into separate files
• Create centralized logger config in utils.py

Added

• Add tool annotations to tools to better describe their effects
• Add security middleware (CORS and TrustedHost protection) for HTTP transport
• Add --allow-origins and --allowed-hosts command line arguments
• Add security environment variables: NEO4J_MCP_SERVER_ALLOW_ORIGINS and NEO4J_MCP_SERVER_ALLOWED_HOSTS
• Update config parsing functions
• Add clear logging for config declaration via cli and env variables

What's Changed

• add security middleware to aura server by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/171
• add logging to utils parsing functions, update tests by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/172
• aura-manager - prep v0.4.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/173

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.4.0...mcp-neo4j-aura-manager-v0.4.0

v0.4.0

Changed

• Change default transport to stdio in Dockerfile

Added

• Add env variable NEO4J_MCP_SERVER_ALLOW_ORIGINS and cli variable --allow-origins to configure CORS Middleware for remote deployments
• Add env variable NEO4J_MCP_SERVER_ALLOWED_HOSTS and cli variable --allowed-hosts to configure Trusted Hosts Middleware for remote deployments
• Update HTTP and SSE transports to use security middleware
• Add comprehensive HTTP transport integration tests with security middleware testing

What's Changed

• General - create common package for shared code by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/167
• Revert "General - create common package for shared code" by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/168
• memory - add security middleware by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/169
• memory - prep v0.4.0 release by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/170

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.4.0...mcp-neo4j-memory-v0.4.0

v0.4.0

Changed

• Change default transport to stdio in Dockerfile

Added

• Added Cypher result sanitation function from Neo4j GraphRAG that removes embedding values from the result
• Add env variable NEO4J_MCP_SERVER_ALLOW_ORIGINS and cli variable --allow-origins to configure CORS Middleware for remote deployments
• Add env variable NEO4J_MCP_SERVER_ALLOWED_HOSTS and cli variable --allowed-hosts to configure Trusted Hosts Middleware for remote deployments
• Update HTTP and SSE transports to use security middleware - fixes CVE-2025-10193
• Added read_neo4j_cypher query timeout configuration via --read-timeout CLI parameter and NEO4J_READ_TIMEOUT environment variable (defaults to 30 seconds)
• Add response token limit for read Cypher responses

What's Changed

• update docker docs, add workflow image and desc by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/147
• Sanitize embedding-like values from cypher read tool by @tomasonjo in https://github.com/neo4j-contrib/mcp-neo4j/pull/154
• cypher - fix docker hub integration bug by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/159
• Add configurable token limit to cypher read tool by @tomasonjo in https://github.com/neo4j-contrib/mcp-neo4j/pull/157
• read query timeout implementation by @rfrneo4j in https://github.com/neo4j-contrib/mcp-neo4j/pull/163
• cypher - add middleware by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/165
• cypher - prep v0.4.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/166

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.4.0...mcp-neo4j-cypher-v0.4.0

v0.4.0

Added

• Add create_new_data_model prompt that provides a structured prompt for generating a graph data model

What's Changed

• Data modeling add guidance prompt by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/141
• data-modeling - prep v0.4.0 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/142

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.3.1...mcp-neo4j-data-modeling-v0.4.0

v0.3.0

Changed

• Update tool return type hints for structured output
• Move Neo4jMemory class and related classes to separate file
• Change tool responses to return the ToolResponse object
• Updated tool argument types with Pydantic models

Added

• Add structured output to tool responses
• Add error handling to catch Neo4j specific errors and improve error responses
• Implement ToolError class from FastMCP
• Add tool annotations
• Add clear warnings for config declaration via cli and env variables

What's Changed

• Minor README updates by @jalakoo in https://github.com/neo4j-contrib/mcp-neo4j/pull/133
• Update http examples to not bind to all interfaces by @Liam-Doodson in https://github.com/neo4j-contrib/mcp-neo4j/pull/136
• memory - add detailed warnings and info for config by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/137

New Contributors

• @johnymontana made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/135
• @jalakoo made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/133
• @Liam-Doodson made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/136

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.3.0...mcp-neo4j-memory-v0.3.0

v0.3.1

Changed

• Update Neo4j Driver syntax to use driver.execute_query(...). This cleans the driver code.

Added

• Add clear warnings for config declaration via cli and env variables

What's Changed

• Cypher refactor driver code by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/130
• Docs: Update mcp-neo4j-cypher command argument flags by @johnymontana in https://github.com/neo4j-contrib/mcp-neo4j/pull/135
• Minor README updates by @jalakoo in https://github.com/neo4j-contrib/mcp-neo4j/pull/133
• Update http examples to not bind to all interfaces by @Liam-Doodson in https://github.com/neo4j-contrib/mcp-neo4j/pull/136
• cypher - add warnings and info for server config, update changelog by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/138
• cypher - prep v0.3.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/139

New Contributors

• @johnymontana made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/135
• @jalakoo made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/133
• @Liam-Doodson made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/136

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.3.0...mcp-neo4j-cypher-v0.3.1

v0.3.0

Fixed

• Remove back slashes from f-string in Mermaid config generation

Added

• Update PR workflow to iterate over Python 3.10 to 3.13
• Add example data model resources
• Add tools to list and retrieve example data models and their Mermaid configurations

What's Changed

• remove backslashes in f-string, update pr workflow to test 3.10 - 3.13 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/127
• feat: Add comprehensive example data models as MCP resources by @rfrneo4j in https://github.com/neo4j-contrib/mcp-neo4j/pull/122
• update changelog, versions, python deps by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/128

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-aura-manager-v0.3.0...mcp-neo4j-data-modeling-v0.3.0

v0.3.0

Changed

• Migrate to FastMCP v2.x

Added

• Add HTTP transport option

What's Changed

• update changelog, dockerfile, versions by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/112

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.2.0...mcp-neo4j-aura-manager-v0.3.0

v0.2.0

Added

• Add HTTP transport option
• Migrate to FastMCP v2.x

What's Changed

• bump version to 0.2.0, clean deps, update changelog by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/111

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.2.0...mcp-neo4j-data-modeling-v0.2.0

v0.2.0

Fixed

• Fix bug in search_nodes method where query arg wasn't passed properly
• Fix bug where stdio transport was always selected
• Fixed argument parsing in server init

Changed

• Implement FastMCP with function decorators to simplify server code
• Add HTTP transport option
• Migrate to FastMCP v2.x
• rename tools to be more clear - search_nodes into search_memories and find_nodes into find_memories_by_name
• Update underlying Pydantic class ObservationAddition to have observations field to be consistent with ObservationDeletion class
• Update Dockerfile to include NEO4J_DATABASE, NEO4J_TRANSPORT, NEO4J_MCP_SERVER_HOST, NEO4J_MCP_SERVER_PORT and NEO4J_MCP_SERVER_PATH env variables

What's Changed

• Update generate-upload-dxt-cypher.yml by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/106
• update version, changelog by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/107

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.3.0...mcp-neo4j-memory-v0.2.0

v0.3.0

Fixed

• Updated the get_neo4j_schema tool to include Relationship properties as well
• Fix bug where params arg wouldn't be parsed correctly

Changed

• Update error handling in read and write tools
• Update get_neo4j_schema tool description
• Update get_neo4j_schema tool to catch missing apoc plugin error explicitly and provide guidance to client and user
• Update error handling for tools to explicitly catch and return Neo4j based errors with details

Added

• Add .dxt file for Cypher MCP server
• Add .dxt file generation to Cypher MCP Publish GitHub action
• Add HTTP transport option
• Migrate to FastMCP v2.x
• Add tool annotations
• Update Dockerfile for http configuration

What's Changed

• Update generate-upload-dxt-cypher.yml by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/85
• add isError to result by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/86
• modify graph schema query by @Btibert3 in https://github.com/neo4j-contrib/mcp-neo4j/pull/78
• Feat/http mode by @rfrneo4j in https://github.com/neo4j-contrib/mcp-neo4j/pull/88
• Cypher update docker deployment by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/99
• Memory updates by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/100
• update fastmcp version, add annotations, update changelog by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/101
• update error handling, changelog by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/102
• update changelog, dxt manifest, versions, dockerfile by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/103
• Cypher fix params parsing issue by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/104

New Contributors

• @Btibert3 made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/78
• @rfrneo4j made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/88

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.2.4-dxt...mcp-neo4j-cypher-v0.3.0

What's Changed

Add dxt file as asset

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.2.4...mcp-neo4j-cypher-v0.2.4-dxt

v0.2.4

Fixed

• Fixed Cypher MCP Docker deployments by allowing user to declare NEO4J_MCP_SERVER_HOST and NEO4J_MCP_SERVER_PORT. Can now declare NEO4J_MCP_SERVER_HOST=0.0.0.0 to use Docker hosted Cypher MCP server.

Added

• NEO4J_MCP_SERVER_HOST and NEO4J_MCP_SERVER_PORT env variables
• --server-host and --server-port cli variables

What's Changed

• add host and port config options by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/76
• update changelog, readme, version by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/77

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.1.5...mcp-neo4j-cypher-v0.2.4

v0.1.5

Fixed

• Remove use of dynamic node labels and relationship types to be compatible with Neo4j versions < 5.26

What's Changed

• Update README.md by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/66
• remove dynamic node labels and rel types, tested with neo4j v5.24 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/70
• update versions, changelog by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/71

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.1.1...mcp-neo4j-memory-v0.1.5

v0.1.1

Fixed

• Shorten tool names to comply with Cursor name length restrictions

Changed

• Removed NVL visualization due to compatibility issues

Added

• Code generation tools for ingestion queries
• Resource that explains the recommended process of ingesting data into Neo4j
• Mermaid visualization configuration generation

What's Changed

• add mermaid viz support by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/61
• add code generation, ingest process resource by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/63
• Fix a typo in README.md by @schubertjan in https://github.com/neo4j-contrib/mcp-neo4j/pull/62
• remove nvl viz by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/64
• prep for data modeling v0.1.1 by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/65

New Contributors

• @schubertjan made their first contribution in https://github.com/neo4j-contrib/mcp-neo4j/pull/62

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-data-modeling-v0.1.0...mcp-neo4j-data-modeling-v0.1.1

v0.1.0

• Basic functionality
  • Expose schemas for Data Model, Node, Relationship and Property
  • Validation tools
• Visualize data model in interactive browser window
• Import / Export from Arrows web application

What's Changed

• Add data modeling mcp server by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/59

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.2.3...mcp-neo4j-data-modeling-v0.1.0

v0.2.3

Added

• Namespace option via CLI or env variables. This allows many Cypher MCP servers to be used at once.
• Allow transport to be specified via env variables

What's Changed

• fix bug in github action for mcp cypher by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/53
• add namespacing for Cypher tools, tested by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/57

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-cypher-v0.2.2...mcp-neo4j-cypher-v0.2.3

v0.2.2

Fixed

• IT no longer has risk of affecting locally deployed Neo4j instances
• Env config now supports NEO4J_URI and NEO4J_URL variables
• Fixed async issues with main server function not being async

Changed

• IT now uses Testcontainers library instead of Docker scripts
• Remove healthcheck from main function

Added

• Support for transport config in cli args

What's Changed

• remove publish on release, add manual trigger by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/39
• add database name arg to memory mcp by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/46
• Fix uri config by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/49
• add transport config, fix main async issue by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/50
• remove healthcheck by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/51
• prep for v0.2.2 publish by @a-s-g93 in https://github.com/neo4j-contrib/mcp-neo4j/pull/52

Full Changelog: https://github.com/neo4j-contrib/mcp-neo4j/compare/mcp-neo4j-memory-v0.1.2...mcp-neo4j-cypher-v0.2.2