Skip to content

Wire up CodeGraph MCP server for code exploration - #50

Merged
ebulgakov merged 2 commits into
mainfrom
chore/wire-up-codegraph-mcp
Aug 5, 2026
Merged

Wire up CodeGraph MCP server for code exploration#50
ebulgakov merged 2 commits into
mainfrom
chore/wire-up-codegraph-mcp

Conversation

@ebulgakov

@ebulgakov ebulgakov commented Aug 5, 2026

Copy link
Copy Markdown
Owner

Summary

  • Registers the codegraph MCP server (.mcp.json, .cursor/mcp.json) so agents can query the pre-built code-structure index instead of grep/Read loops
  • Adds a UserPromptSubmit hook + mcp__codegraph__* permission in .claude/settings.json
  • Documents usage in CLAUDE.md
  • Ignores CodeGraph's local runtime files (db/socket/pid/log) via .codegraph/.gitignore, keeping only the ignore rule itself tracked

Test plan

  • Verified daemon runs and codegraph explore / mcp__codegraph__codegraph_explore return correct verbatim source + call graph
  • Confirmed git status only tracks .codegraph/.gitignore, not the runtime db/socket/pid/log
  • pnpm exec lint-staged + nuxt typecheck passed via pre-commit hook

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added CodeGraph integration for supported development tools.
    • Enabled prompt-based CodeGraph actions and MCP-powered code exploration.
    • Added workflows for symbol lookup and call-path discovery.
  • Documentation

    • Documented CodeGraph usage and when it should be skipped.
  • Chores

    • Added configuration to preserve project metadata while ignoring generated CodeGraph contents.

Registers the codegraph MCP server in .mcp.json/.cursor/mcp.json, adds a
UserPromptSubmit hook and mcp__codegraph__* permission in
.claude/settings.json, documents usage in CLAUDE.md, and ignores
CodeGraph's local runtime files (db/socket/pid/log) via .codegraph/.gitignore.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Aug 5, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@ebulgakov, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 34 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 2d0a1a61-e1a7-4608-94c5-f6d74eca8757

📥 Commits

Reviewing files that changed from the base of the PR and between fc91e2f and 9a5fec5.

📒 Files selected for processing (2)
  • .cursor/mcp.json
  • CLAUDE.md
📝 Walkthrough

Walkthrough

The changes integrate CodeGraph with Claude and Cursor through MCP configuration and a prompt hook. They exclude local CodeGraph data and document MCP and shell-based exploration workflows.

Changes

CodeGraph integration

Layer / File(s) Summary
CodeGraph tool integration
.claude/settings.json, .cursor/mcp.json, .mcp.json
Adds CodeGraph MCP server configurations, a Claude UserPromptSubmit hook, and permissions for CodeGraph MCP tools.
Repository guidance and local data handling
.codegraph/.gitignore, CLAUDE.md
Excludes local CodeGraph data and documents CodeGraph usage and indexing conditions.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the primary change: integrating the CodeGraph MCP server for code exploration.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/wire-up-codegraph-mcp

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@vercel

vercel Bot commented Aug 5, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
linkfolio Ready Ready Preview Aug 5, 2026 9:30am

@ebulgakov ebulgakov added the review Call @claude review & @coderabbit review label Aug 5, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.cursor/mcp.json:
- Line 12: Remove the machine-specific absolute path from the MCP server args in
the configuration, and either omit --path when Cursor uses the workspace
directory or replace it with a workspace-relative resolution supported by the
configuration. Do not commit a user-specific local path; use an untracked local
configuration if an explicit path is required.

In `@CLAUDE.md`:
- Around line 80-85: Update the CodeGraph guidance in CLAUDE.md to require a
real index-health check, such as codegraph status, before using CodeGraph. Do
not treat the mere presence of the .codegraph/ directory as proof of an
available index; preserve the instruction to skip CodeGraph when the repository
is not indexed.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 470f2cd2-430b-4b77-982e-8a469055ef5c

📥 Commits

Reviewing files that changed from the base of the PR and between d2a50cb and fc91e2f.

📒 Files selected for processing (5)
  • .claude/settings.json
  • .codegraph/.gitignore
  • .cursor/mcp.json
  • .mcp.json
  • CLAUDE.md

Comment thread .cursor/mcp.json Outdated
Comment thread CLAUDE.md Outdated
.cursor/mcp.json committed a machine-specific absolute --path other
contributors won't have; drop it, mirroring .mcp.json's args which
already omit it and rely on cwd.

CLAUDE.md's "no .codegraph/ dir means unindexed" check no longer holds
now that .codegraph/.gitignore is tracked, so the directory exists on
every checkout regardless of whether this machine has actually run the
daemon and built a database. Point at `codegraph status` instead.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@ebulgakov
ebulgakov merged commit f0666ea into main Aug 5, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review Call @claude review & @coderabbit review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant