Releases: neo4j-contrib/mcp-neo4j
Releases · neo4j-contrib/mcp-neo4j
mcp-neo4j-aura-manager-v0.4.0
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-originsand--allowed-hostscommand line arguments - Add security environment variables:
NEO4J_MCP_SERVER_ALLOW_ORIGINSandNEO4J_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 #171
- add logging to utils parsing functions, update tests by @a-s-g93 in #172
- aura-manager - prep v0.4.0 by @a-s-g93 in #173
Full Changelog: mcp-neo4j-memory-v0.4.0...mcp-neo4j-aura-manager-v0.4.0
mcp-neo4j-cypher-v0.4.0
v0.4.0
Changed
- Change default transport to
stdioin Dockerfile
Added
- Added Cypher result sanitation function from Neo4j GraphRAG that removes embedding values from the result
- Add env variable
NEO4J_MCP_SERVER_ALLOW_ORIGINSand cli variable--allow-originsto configure CORS Middleware for remote deployments - Add env variable
NEO4J_MCP_SERVER_ALLOWED_HOSTSand cli variable--allowed-hoststo configure Trusted Hosts Middleware for remote deployments - Update HTTP and SSE transports to use security middleware - fixes CVE-2025-10193
- Added
read_neo4j_cypherquery timeout configuration via--read-timeoutCLI parameter andNEO4J_READ_TIMEOUTenvironment 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 #147
- Sanitize embedding-like values from cypher read tool by @tomasonjo in #154
- cypher - fix docker hub integration bug by @a-s-g93 in #159
- Add configurable token limit to cypher read tool by @tomasonjo in #157
- read query timeout implementation by @rfrneo4j in #163
- cypher - add middleware by @a-s-g93 in #165
- cypher - prep v0.4.0 by @a-s-g93 in #166
Full Changelog: mcp-neo4j-data-modeling-v0.4.0...mcp-neo4j-cypher-v0.4.0
mcp-neo4j-data-modeling-v0.4.0
v0.4.0
Added
- Add
create_new_data_modelprompt that provides a structured prompt for generating a graph data model
What's Changed
- Data modeling add guidance prompt by @a-s-g93 in #141
- data-modeling - prep v0.4.0 by @a-s-g93 in #142
Full Changelog: mcp-neo4j-cypher-v0.3.1...mcp-neo4j-data-modeling-v0.4.0
mcp-neo4j-memory-v0.3.0
v0.3.0
Changed
- Update tool return type hints for structured output
- Move
Neo4jMemoryclass and related classes to separate file - Change tool responses to return the
ToolResponseobject - 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
ToolErrorclass 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 #133
- Update http examples to not bind to all interfaces by @Liam-Doodson in #136
- memory - add detailed warnings and info for config by @a-s-g93 in #137
New Contributors
- @johnymontana made their first contribution in #135
- @jalakoo made their first contribution in #133
- @Liam-Doodson made their first contribution in #136
Full Changelog: mcp-neo4j-data-modeling-v0.3.0...mcp-neo4j-memory-v0.3.0
mcp-neo4j-cypher-v0.3.1
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 #130
- Docs: Update mcp-neo4j-cypher command argument flags by @johnymontana in #135
- Minor README updates by @jalakoo in #133
- Update http examples to not bind to all interfaces by @Liam-Doodson in #136
- cypher - add warnings and info for server config, update changelog by @a-s-g93 in #138
- cypher - prep v0.3.1 by @a-s-g93 in #139
New Contributors
- @johnymontana made their first contribution in #135
- @jalakoo made their first contribution in #133
- @Liam-Doodson made their first contribution in #136
Full Changelog: mcp-neo4j-data-modeling-v0.3.0...mcp-neo4j-cypher-v0.3.1
mcp-neo4j-data-modeling-v0.3.0
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 #127
- feat: Add comprehensive example data models as MCP resources by @rfrneo4j in #122
- update changelog, versions, python deps by @a-s-g93 in #128
Full Changelog: mcp-neo4j-aura-manager-v0.3.0...mcp-neo4j-data-modeling-v0.3.0
mcp-neo4j-data-modeling-v0.2.0
v0.2.0
Added
- Add HTTP transport option
- Migrate to FastMCP v2.x
What's Changed
Full Changelog: mcp-neo4j-memory-v0.2.0...mcp-neo4j-data-modeling-v0.2.0
mcp-neo4j-aura-manager-v0.3.0
v0.3.0
Changed
- Migrate to FastMCP v2.x
Added
- Add HTTP transport option
What's Changed
Full Changelog: mcp-neo4j-data-modeling-v0.2.0...mcp-neo4j-aura-manager-v0.3.0
mcp-neo4j-memory-v0.2.0
v0.2.0
Fixed
- Fix bug in
search_nodesmethod 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_nodesintosearch_memoriesandfind_nodesintofind_memories_by_name - Update underlying Pydantic class
ObservationAdditionto haveobservationsfield to be consistent withObservationDeletionclass - Update Dockerfile to include
NEO4J_DATABASE,NEO4J_TRANSPORT,NEO4J_MCP_SERVER_HOST,NEO4J_MCP_SERVER_PORTandNEO4J_MCP_SERVER_PATHenv variables
What's Changed
- Update generate-upload-dxt-cypher.yml by @a-s-g93 in #106
- update version, changelog by @a-s-g93 in #107
Full Changelog: mcp-neo4j-cypher-v0.3.0...mcp-neo4j-memory-v0.2.0
mcp-neo4j-cypher-v0.3.0
v0.3.0
Fixed
- Updated the
get_neo4j_schematool to include Relationship properties as well - Fix bug where
paramsarg wouldn't be parsed correctly
Changed
- Update error handling in read and write tools
- Update
get_neo4j_schematool description - Update
get_neo4j_schematool 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 #85
- add isError to result by @a-s-g93 in #86
- modify graph schema query by @Btibert3 in #78
- Feat/http mode by @rfrneo4j in #88
- Cypher update docker deployment by @a-s-g93 in #99
- Memory updates by @a-s-g93 in #100
- update fastmcp version, add annotations, update changelog by @a-s-g93 in #101
- update error handling, changelog by @a-s-g93 in #102
- update changelog, dxt manifest, versions, dockerfile by @a-s-g93 in #103
- Cypher fix params parsing issue by @a-s-g93 in #104
New Contributors
Full Changelog: mcp-neo4j-cypher-v0.2.4-dxt...mcp-neo4j-cypher-v0.3.0