Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: First WIP attempt at Neo4j MCP Server #105

Closed
wants to merge 4 commits into from

Conversation

jexp
Copy link
Contributor

@jexp jexp commented Nov 28, 2024

It supports the following tools:

  • get-neo4j-schema
  • read-neo4j-cypher
  • write-neo4j-cypher

Description

GH Issue: #58

Server Details

  • Server: neo4j
  • Changes to: added 3 initial tools (get-neo4j-schema, write-neo4j-cypher, read-neo4j-cypher)

Motivation and Context

We want to enable people to access Neo4j knowledge graphs from Claude.ai, it's actually quite impressive what it can do out of the box with just a neo4j conenction, by generating the cypher statements (see screenshots below)

How Has This Been Tested?

I tested it with claude.ai and a neo4j test database, see screenshots below.
Also tested some error conditions, then claude recovered and tried a different approach.

Breaking Changes

No, because this is an initial server contribution.

Types of changes

  • New MCP Server
  • New features
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update (Readme)

Checklist

  • I have read the MCP Protocol Documentation
  • My server follows MCP security best practices
  • I have updated the server's README accordingly
  • I have tested this with an LLM client
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have documented all environment variables and configuration options

Additional context

Screenshots from configuring the server with a demo database and readonly user and usage of that database with claude.ai desktop client

Bildschirmfoto 2024-11-28 um 10 15 05 Bildschirmfoto 2024-11-28 um 10 15 41 Bildschirmfoto 2024-11-28 um 10 18 44 Bildschirmfoto 2024-11-28 um 10 36 31

It supports the following tools:

- get-neo4j-schema
- read-neo4j-cypher
- write-neo4j-cypher
@jexp
Copy link
Contributor Author

jexp commented Nov 28, 2024

Ping @dsp-ant :) (if you're not in the US otherwise happy thanksgiving 🦃 )

@jexp jexp changed the title First WIP attempt at Neo4j MCP Server feat: First WIP attempt at Neo4j MCP Server Nov 30, 2024
@jspahrsummers
Copy link
Member

Thank you for taking the time to build this! We've now made some changes to how we'll manage the servers repo going forward.

TLDR: We're restructuring the MCP servers repository to focus on reference implementations only. New server implementations should be developed in separate repositories and can be added as links to our README, rather than submitted as PRs to this repository.

In line with that new approach, I'll close out this PR, but we would love to include a link to this server once it's in its own repo. Please do submit a new PR when it's ready!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants