Refactor mcp neo4j cypher (#13)

* refactor cypher mcp
* broken neo4j driver impl. going to try Server class
* add env config for driver
* fix healthcheck
* add env support with cli, add changelog, test with claude desktop and inspector
* implement json responses for tools
* add default serializer to write results
* Update CHANGELOG.txt

---------

Co-authored-by: Michael Hunger <[email protected]>

Author: a-s-g93

servers/mcp-neo4j-cypher/inspector.sh

@@ -0,0 +1,2 @@
+# test mcp-neo4j-cypher with a local database and Inspector
+npx @modelcontextprotocol/inspector uv --directory src/mcp_neo4j_cypher run mcp-neo4j-cypher --db-url bolt://localhost:7687 --username neo4j --password password --database neo4j

servers/mcp-neo4j-cypher/pyproject.toml

@@ -4,7 +4,11 @@ version = "0.1.2"
 description = "A simple Neo4j MCP server"
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = ["mcp>=1.6.0", "neo4j>=5.26.0"]
+dependencies = [
+    "mcp[cli]>=1.6.0",
+    "neo4j>=5.26.0",
+    "pydantic>=2.10.1",
+]
 
 [build-system]
 requires = ["hatchling"]

servers/mcp-neo4j-cypher/pyrightconfig.json

@@ -0,0 +1,4 @@
+{
+    "venvPath": ".",
+    "venv": ".venv"
+} 

servers/mcp-neo4j-cypher/src/mcp_neo4j_cypher/CHANGELOG.txt

@@ -0,0 +1,18 @@
+## Next
+
+### Fixed
+
+### Changed
+
+* Refactor mcp-neo4j-cypher to use the FastMCP class
+* Implement Neo4j async driver
+* Tool responses now return JSON serialized results
+
+### Added
+
+* Add support for environment variables
+
+
+## v0.1.1
+
+...

servers/mcp-neo4j-cypher/src/mcp_neo4j_cypher/__init__.py

@@ -6,19 +6,23 @@
 
 def main():
     """Main entry point for the package."""
-    parser = argparse.ArgumentParser(description='Neo4j Cypher MCP Server')
-    parser.add_argument('--db-url', 
-                       default="bolt://localhost:7687",
-                       help='Neo4j connection URL')
-    parser.add_argument('--username', 
-                       default="neo4j",
-                       help='Neo4j username')
-    parser.add_argument('--password', 
-                       default="password",
-                       help='Neo4j password')
-    
+    parser = argparse.ArgumentParser(description="Neo4j Cypher MCP Server")
+    parser.add_argument("--db-url", default=None, help="Neo4j connection URL")
+    parser.add_argument("--username", default=None, help="Neo4j username")
+    parser.add_argument("--password", default=None, help="Neo4j password")
+    parser.add_argument("--database", default=None, help="Neo4j database name")
+
     args = parser.parse_args()
-    asyncio.run(server.main(args.db_url, args.username, args.password))
+    asyncio.run(
+        server.main(
+            args.db_url or os.getenv("NEO4J_URI", "bolt://localhost:7687"),
+            args.username or os.getenv("NEO4J_USERNAME", "neo4j"),
+            args.password or os.getenv("NEO4J_PASSWORD", "password"),
+            args.database or os.getenv("NEO4J_DATABASE", "neo4j"),
+        )
+    )
+
+    # asyncio.run(server.main())
 
 
 # Optionally expose other important items at package level