Skip to content

feat: MCP server — expose knowledge graph to AI assistants#124

Open
SimplicityGuy wants to merge 4 commits intomainfrom
worktree-feat-mcp-server
Open

feat: MCP server — expose knowledge graph to AI assistants#124
SimplicityGuy wants to merge 4 commits intomainfrom
worktree-feat-mcp-server

Conversation

@SimplicityGuy
Copy link
Owner

Summary

Closes #83.

  • Adds mcp-server/ package with 9 MCP tools wrapping existing Neo4j and PostgreSQL queries via FastMCP
  • Tools: search, get_artist_details, get_label_details, get_release_details, get_genre_details, get_style_details, find_path, get_trends, get_graph_stats
  • Transports: stdio (default, for Claude Desktop/Cursor/Zed) + streamable-http (hosted)
  • Distribution: discogsography-mcp entry point (uvx discogsography-mcp)
  • Reuses common.AsyncResilientNeo4jDriver, common.AsyncPostgreSQLPool, and all existing query modules
  • Lifespan-managed database connections with proper startup/shutdown
  • 24 unit tests, all passing; full test suite (1360 tests) unaffected
  • README with config snippets for Claude Desktop, Claude Code, Cursor, and Zed

Test plan

  • 24 new unit tests covering all 9 tools, edge cases, entry point parsing
  • All 1360 existing tests still pass (uv run pytest -m 'not e2e')
  • uv run ruff check . — clean
  • uv run mypy mcp-server/ — clean
  • All pre-commit hooks pass
  • Manual: discogsography-mcp connects via stdio to Claude Desktop with live Neo4j/PostgreSQL

🤖 Generated with Claude Code

Add `mcp-server/` package using FastMCP that wraps existing Neo4j and
PostgreSQL queries as 9 MCP tools callable by Claude Desktop, Cursor,
Zed, and other AI assistants.

Tools: search, get_artist_details, get_label_details, get_release_details,
get_genre_details, get_style_details, find_path, get_trends, get_graph_stats.

Transports: stdio (default) and streamable-http (hosted).
Distribution: `discogsography-mcp` via PyPI (`uvx discogsography-mcp`).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@codecov
Copy link

codecov bot commented Mar 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions
Copy link
Contributor

E2E Coverage (webkit)

Totals Coverage
Statements: 34.91% ( 693 / 1985 )
Lines: 34.91% ( 693 / 1985 )

StandWithUkraine

@github-actions
Copy link
Contributor

E2E Coverage (chromium)

Totals Coverage
Statements: 34.91% ( 693 / 1985 )
Lines: 34.91% ( 693 / 1985 )

StandWithUkraine

@github-actions
Copy link
Contributor

E2E Coverage (firefox)

Totals Coverage
Statements: 34.91% ( 693 / 1985 )
Lines: 34.91% ( 693 / 1985 )

StandWithUkraine

@github-actions
Copy link
Contributor

E2E Coverage (webkit - iPhone 15)

Totals Coverage
Statements: 34.91% ( 693 / 1985 )
Lines: 34.91% ( 693 / 1985 )

StandWithUkraine

@github-actions
Copy link
Contributor

E2E Coverage (webkit - iPad Pro 11)

Totals Coverage
Statements: 34.91% ( 693 / 1985 )
Lines: 34.91% ( 693 / 1985 )

StandWithUkraine

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.

feat: MCP Server — expose the knowledge graph to AI assistants

1 participant