이 저장소는 Neo4j 그래프 데이터베이스와 모델 Context Protocol (MCP) 서버 개발을 보여줍니다. 그것은 전자 상거래 응용 프로그램에 대한 범용 Cypher 쿼리 및 사용자 정의 구현을위한 공식 Neo4j MCP 서버를 포함한다.

개요

• Module 1: mcp-neo4j-cypher] MCP 서버를 사용하여 방사성 데이터 분석을 위한 Claude Desktop
• ** 모듈 2**: 자체 MCP 서버를 구축하고

Module 1: mcp-neo4j-cypher MCP 서버를 사용하여 Claude Desktop for exploratory data analysis

mcp-neo4j-cypher 서버는 네오4j 데이터베이스에 대한 포괄적인 Cypher 쿼리 기능을 제공하는 네오4j MCP 구현입니다.

특징

• execute_cypher - Neo4j 데이터베이스에 대한 임의의 Cypher 쿼리 실행
• explore_schema - 데이터베이스 스키마 (노드 라벨, 관계 유형, 속성 키) -get_database_info - Neo4j 데이터베이스에 대한 정보를 얻으십시오.
• Schema-agnostic - Neo4j 데이터베이스 구조로 작업
• **APOC 통합 ** - 향상된 기능을 위한 Neo4j APOC 플러그인 활용

Neo4j Aura와 Claude 데스크탑으로 설정

1. ** Neo4j Aura 데이터베이스 ** :

• Neo4j Aura에 가입

Neo4j MCP Workshop

This repository demonstrates Model Context Protocol (MCP) server development with Neo4j graph databases. It includes both the official Neo4j MCP server for general-purpose Cypher querying and custom implementations for ecommerce applications.

Outline

• Module 1: Using the mcp-neo4j-cypher MCP server with Claude Desktop for exploratory data analysis
• Module 2: Building your own MCP server and

Module 1: Using the mcp-neo4j-cypher MCP server with Claude Desktop for exploratory data analysis

The mcp-neo4j-cypher server is a Neo4j MCP implementation that provides comprehensive Cypher query capabilities for any Neo4j database.

Features

• execute_cypher - Execute arbitrary Cypher queries against your Neo4j database
• explore_schema - Explore database schema (node labels, relationship types, property keys)
• get_database_info - Get information about your Neo4j database
• Schema-agnostic - Works with any Neo4j database structure
• APOC Integration - Leverages Neo4j APOC plugin for enhanced functionality

Setup with Neo4j Aura and Claude Desktop

1. Create Neo4j Aura Database:

   • Sign up at Neo4j Aura
   • Create a new database instance
   • Note your connection URI, username, and password

2. Configure Claude Desktop: Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "neo4j-database": {
      "command": "uvx",
      "args": [ "[email protected]", "--transport", "stdio"  ],
      "env": {
        "NEO4J_URI": "",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "",
        "NEO4J_DATABASE": "neo4j"
      }
    }
  }
}

3. Test the Integration:
   • Restart Claude Desktop
   • Ask Claude to explore your Neo4j database: “What does my Neo4j database contain?”
   • Try queries like: “Find all nodes in my database” or “Show me the schema of my Neo4j database”

Module 2: Building Your Own MCP Server

Creating Custom MCP Servers

This section covers how to build your own MCP servers using different SDKs and frameworks. The examples demonstrate domain-specific implementations for ecommerce applications.

MCP Server Development SDKs

Python SDKs

FastMCP (Used in this project)

• Package: fastmcp
• Features: High-level Python framework for MCP server development
• Best for: Rapid prototyping and Python developers
• Installation: pip install fastmcp

Official Python MCP SDK

• Package: mcp
• Features: Official Python implementation of MCP protocol
• Best for: Full control over MCP protocol implementation
• Installation: pip install mcp

TypeScript SDKs

Official TypeScript MCP SDK (Used in this project)

• Package: @modelcontextprotocol/sdk