Building GraphRAG Python MCP tools

This repository supports the Building GraphRAG Python MCP tools course on GraphAcademy.

The course challenges you to do the following:

1. Build an MCP Server using MCP Python SDK..

2. Run the MCP Inspector and inspect your MCP Server.

3. Build a tool that connects to Neo4j.

4. Expose a Label and Property combination as a Resource.

5. Create a prompt template to help an MCP Host perform text-to-cypher.

6. Use tools to build novel tools for your MCP server.

Enroll now

Running the Interactive MCP Client

This repository includes a Python MCP client for testing your server.

Start the MCP Server

cd solutions/server
uv run main.py

Run the Interactive Client (in a separate terminal)

cd client
uv venv
source .venv/bin/activate
uv pip install -e .
python main.py

The client provides an interactive menu to:

• List available tools

• Select and execute tools

• Provide parameters based on tool schemas

• View results

Select a tool by number, provide any required parameters, and press 0 or q to exit.