{"_id":"@alanse/mcp-neo4j-server","_rev":"3-22945b274470ccd8acf98dc041ae1374","name":"@alanse/mcp-neo4j-server","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@alanse/mcp-neo4j-server","version":"0.1.0","keywords":["mcp","neo4j","graph-database","claude","natural-language","database"],"author":{"name":"Daichi Okazaki"},"license":"MIT","_id":"@alanse/mcp-neo4j-server@0.1.0","maintainers":[{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp"}],"homepage":"https://github.com/da-okazaki/mcp-neo4j-server#readme","bugs":{"url":"https://github.com/da-okazaki/mcp-neo4j-server/issues"},"bin":{"mcp-neo4j":"build/index.js"},"dist":{"shasum":"0b8a6d8b73c5a8a379b555029f5bf5bacdf56f64","tarball":"https://registry.npmjs.org/@alanse/mcp-neo4j-server/-/mcp-neo4j-server-0.1.0.tgz","fileCount":5,"integrity":"sha512-Jwp80UeIM+dLarsWYzZ4Zv5rz8XaXN3XRB5Ywt9VaHKKSdaNaBjhiHzlR2JkH6TxLNJ2KB0reZGWt/rrOyFyaQ==","signatures":[{"sig":"MEQCIEe5vbreYmkAOe/+ijM4DnXEKiznkXu4v85wfli7c3LBAiBszj4u+fsm2w7rK85gyihh7D8cZv+RNPugUsfnoGiFUA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":16373},"type":"module","gitHead":"02787204d40581ec4a65eaa40825089b391facda","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"_npmUser":{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp"},"repository":{"url":"git+https://github.com/da-okazaki/mcp-neo4j-server.git","type":"git"},"_npmVersion":"10.8.2","description":"Neo4j MCP server for integrating Neo4j graph database with Claude Desktop through natural language interactions","directories":{},"_nodeVersion":"21.6.2","dependencies":{"neo4j-driver":"^5.27.0","@modelcontextprotocol/sdk":"0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-neo4j-server_0.1.0_1736083647745_0.9640987074455376","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@alanse/mcp-neo4j-server","version":"0.1.1","keywords":["mcp","neo4j","graph-database","claude","natural-language","database"],"author":{"name":"Daichi Okazaki"},"license":"MIT","_id":"@alanse/mcp-neo4j-server@0.1.1","maintainers":[{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp"}],"homepage":"https://github.com/da-okazaki/mcp-neo4j-server#readme","bugs":{"url":"https://github.com/da-okazaki/mcp-neo4j-server/issues"},"bin":{"mcp-neo4j":"build/index.js"},"dist":{"shasum":"aecbf3ebb65e6ce3d7902e83b33a7980825b4fdf","tarball":"https://registry.npmjs.org/@alanse/mcp-neo4j-server/-/mcp-neo4j-server-0.1.1.tgz","fileCount":6,"integrity":"sha512-Wg32P3gPar1k2nu62ZABxY2sKIpJQmBoMiQISa6bycIAP5BDtU0kgiYqzm6WA0HjUtIUjerirYSsTAScQaubmw==","signatures":[{"sig":"MEQCIHkSHtUyzEfmx6MWli2HWi3xQw6LvvpS7J1BMeerL70WAiBN0jXuCtWav07hkG67ZX4vkgvPLyjJktrl/QAIsTQzpg==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":17451},"type":"module","gitHead":"3cb975ff1b342eb3f91495af5c7f55b6502e58ff","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"_npmUser":{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp"},"repository":{"url":"git+https://github.com/da-okazaki/mcp-neo4j-server.git","type":"git"},"_npmVersion":"10.8.2","description":"Neo4j MCP server for integrating Neo4j graph database with Claude Desktop through natural language interactions","directories":{},"_nodeVersion":"21.6.2","dependencies":{"neo4j-driver":"^5.27.0","@modelcontextprotocol/sdk":"0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24"},"_npmOperationalInternal":{"tmp":"tmp/mcp-neo4j-server_0.1.1_1736084623602_0.4962079797354939","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@alanse/mcp-neo4j-server","version":"0.2.0","description":"Neo4j MCP server for integrating Neo4j graph database with Claude Desktop through natural language interactions","type":"module","bin":{"mcp-neo4j":"build/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","prepare":"npm run build","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"0.6.0","neo4j-driver":"^5.27.0","uuid":"^11.0.4"},"devDependencies":{"@types/node":"^20.11.24","ts-node":"^10.9.2","typescript":"^5.3.3"},"keywords":["mcp","neo4j","graph-database","claude","natural-language","database"],"author":{"name":"Daichi Okazaki"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/da-okazaki/mcp-neo4j-server.git"},"bugs":{"url":"https://github.com/da-okazaki/mcp-neo4j-server/issues"},"homepage":"https://github.com/da-okazaki/mcp-neo4j-server#readme","_id":"@alanse/mcp-neo4j-server@0.2.0","gitHead":"d903805a2cd8b12b697c49581a483f7412e5e0ab","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-IPBN5J/X6EviR+2i860c/YRRNit+vdUZLSxHW+GZyAZIHIV4QFdfP5LOPVtR+Kuacwm1EEigFrfvq3UwT0VXAA==","shasum":"10fd796d8ce7ef5637640fd3031973d1c09556bb","tarball":"https://registry.npmjs.org/@alanse/mcp-neo4j-server/-/mcp-neo4j-server-0.2.0.tgz","fileCount":6,"unpackedSize":19032,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCkp63fMNoWpHJ90fMbt6686gTcXw3mBO8IUUqCc91mVgIhAOHOuikEQ2biW/WoEsbTRT5a9NUmn36wbzqJzZtEHg+v"}]},"_npmUser":{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp","actor":{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp","type":"user"}},"directories":{},"maintainers":[{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-neo4j-server_0.2.0_1751557379989_0.6126786037471219"},"_hasShrinkwrap":false}},"time":{"created":"2025-01-05T13:27:27.610Z","modified":"2025-07-03T15:43:00.347Z","0.1.0":"2025-01-05T13:27:27.971Z","0.1.1":"2025-01-05T13:43:43.831Z","0.2.0":"2025-07-03T15:43:00.163Z"},"bugs":{"url":"https://github.com/da-okazaki/mcp-neo4j-server/issues"},"author":{"name":"Daichi Okazaki"},"license":"MIT","homepage":"https://github.com/da-okazaki/mcp-neo4j-server#readme","keywords":["mcp","neo4j","graph-database","claude","natural-language","database"],"repository":{"type":"git","url":"git+https://github.com/da-okazaki/mcp-neo4j-server.git"},"description":"Neo4j MCP server for integrating Neo4j graph database with Claude Desktop through natural language interactions","maintainers":[{"name":"alanse-daichi","email":"daichi.okazaki@alanse.co.jp"}],"readme":"# MCP Neo4j Server\n[![smithery badge](https://smithery.ai/badge/@alanse/mcp-neo4j-server)](https://smithery.ai/server/@alanse/mcp-neo4j-server)\n\nAn MCP server that provides integration between Neo4j graph database and Claude Desktop, enabling graph database operations through natural language interactions.\n\n\"Neo4j\n\n## Quick Start\n\nYou can run this MCP server directly using npx:\n\n```bash\nnpx @alanse/mcp-neo4j\n```\n\nOr add it to your Claude Desktop configuration:\n\n```json\n{\n \"mcpServers\": {\n \"neo4j\": {\n \"command\": \"npx\",\n \"args\": [\"@alanse/mcp-neo4j-server\"],\n \"env\": {\n \"NEO4J_URI\": \"bolt://localhost:7687\",\n \"NEO4J_USERNAME\": \"neo4j\",\n \"NEO4J_PASSWORD\": \"your-password\",\n \"NEO4J_DATABASE\": \"neo4j\"\n }\n }\n }\n}\n```\n\n## Features\n\nThis server provides tools for interacting with a Neo4j database:\n\n### Neo4j Enterprise Support\n\nThis server now supports connecting to specific databases in Neo4j Enterprise Edition. By default, it connects to the \"neo4j\" database, but you can specify a different database using the `NEO4J_DATABASE` environment variable.\n\n### Tools\n\n- `execute_query`: Execute Cypher queries on the Neo4j database\n - Supports all types of Cypher queries (READ, CREATE, UPDATE, DELETE)\n - Returns query results in a structured format\n - Parameters can be passed to prevent injection attacks\n\n- `create_node`: Create a new node in the graph database\n - Specify node labels and properties\n - Returns the created node with its internal ID\n - Supports all Neo4j data types for properties\n\n- `create_relationship`: Create a relationship between two existing nodes\n - Define relationship type and direction\n - Add properties to relationships\n - Requires node IDs for source and target nodes\n\n## Installation\n\n### Installing via Smithery\n\nTo install MCP Neo4j Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@alanse/mcp-neo4j-server):\n\n```bash\nnpx -y @smithery/cli install @alanse/mcp-neo4j-server --client claude\n```\n\n### For Development\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/da-okazaki/mcp-neo4j-server.git\ncd mcp-neo4j-server\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Build the project:\n```bash\nnpm run build\n```\n\n## Configuration\n\nThe server requires the following environment variables:\n\n- `NEO4J_URI`: Neo4j database URI (default: bolt://localhost:7687)\n- `NEO4J_USERNAME`: Neo4j username (default: neo4j)\n- `NEO4J_PASSWORD`: Neo4j password (required)\n- `NEO4J_DATABASE`: Neo4j database name (default: neo4j) - Use this to connect to a specific database in Neo4j Enterprise\n\n## Usage Examples\n\nHere are examples of how you can interact with the Neo4j database using natural language:\n\n### Connecting to a Specific Database\n\nFor Neo4j Enterprise users with multiple databases, you can specify which database to connect to:\n\n```json\n{\n \"env\": {\n \"NEO4J_URI\": \"bolt://localhost:7687\",\n \"NEO4J_USERNAME\": \"neo4j\",\n \"NEO4J_PASSWORD\": \"your-password\",\n \"NEO4J_DATABASE\": \"myCustomDatabase\"\n }\n}\n```\n\nThis will connect to \"myCustomDatabase\" instead of the default \"neo4j\" database.\n\n### Querying Data\n\nYou can ask questions like:\n- \"Show me all employees in the Sales department\"\n- \"Find the top 5 oldest customers\"\n- \"Who has purchased more than 3 products in the last month?\"\n\nExample:\n```\nUser: \"Show me all employees in the Sales department\"\n\nClaude: Let me query the database for Sales department employees.\n\n[Executes query internally: MATCH (e:Employee)-[:WORKS_IN]->(d:Department {name: 'Sales'}) RETURN e.name, e.position]\n\nResult:\n- John Smith (Sales Manager)\n- Sarah Johnson (Sales Representative)\n- Mike Brown (Account Executive)\n```\n\n### Creating Data\n\nYou can give instructions like:\n- \"Add a new person named John Doe who is 30 years old\"\n- \"Create a product called 'Premium Coffee' with price $24.99\"\n- \"Add a new department called 'Research & Development'\"\n\nExample:\n```\nUser: \"Add a new person named John Doe who is 30 years old\"\n\nClaude: I'll create a new Person node with the provided information.\n\n[Creates node internally with label 'Person' and properties {name: 'John Doe', age: 30}]\n\nResult: Created new person node with ID: 123\n```\n\n### Creating Relationships\n\nYou can request relationships like:\n- \"Make John Doe friends with Jane Smith\"\n- \"Set Product A as a component of Product B\"\n- \"Assign John Doe to the Sales department\"\n\nExample:\n```\nUser: \"Make John Doe friends with Jane Smith\"\n\nClaude: I'll create a friendship relationship between these two people.\n\n[Creates relationship internally: MATCH (a:Person {name: 'John Doe'}), (b:Person {name: 'Jane Smith'})\nCREATE (a)-[:FRIENDS_WITH {since: '2024-01-05'}]->(b)]\n\nResult: Created friendship relationship between John Doe and Jane Smith\n```\n\n### Complex Operations\n\nYou can perform more complex operations with natural language:\n- \"Find all products purchased by customers who live in New York\"\n- \"Show me friends of friends of John Doe\"\n- \"Calculate the average age of employees in each department\"\n\nExample:\n```\nUser: \"Find all products purchased by customers who live in New York\"\n\nClaude: I'll query the database for this information.\n\n[Executes query internally:\nMATCH (c:Customer {city: 'New York'})-[:PURCHASED]->(p:Product)\nRETURN c.name, collect(p.name) as products]\n\nResult:\n- Alice Wilson: [Premium Coffee, Tea Set, Cookies]\n- Bob Miller: [Premium Coffee, Water Bottle]\n```\n\n## Testing\n\nRun the test suite:\n\n```bash\nnpm test\n```\n\n## License\n\nMIT\n\n","readmeFilename":"README.md"}