Skip to main content
Glama

nexus-serena-mcp

⚑ Semantic Coding Agent IDE Toolkit & Live Documentation MCP Server β€” Symbol


⚑ Why We Built It

Modern AI coding agents often suffer from limited context windows, hallucinated function signatures, and fragile regex search-and-replace. nexus-serena-mcp was engineered by NexusVibe AI Tech to equip AI IDEs and autonomous coding agents (Claude Code, Cursor, VS Code, Codex, Antigravity) with AST-level semantic precision, zero-dependency symbol navigation, surgical refactoring, and live documentation resolution.


Related MCP server: codebase-rag

πŸ—οΈ Architecture & 3-Layer Workflow

graph TD
    subgraph Client Layer
        A[Claude Code / Cursor / VS Code / Codex / Antigravity]
    end

    subgraph MCP JSON-RPC 2.0 Layer
        B[nexus_serena_mcp Server Engine v1.2.0]
    end

    subgraph Core Execution Engine
        C1[find_symbol_definition & find_symbol_references]
        C2[surgical_replace_symbol AST Engine]
        C3[resolve_library_docs & project_onboarding_memory]
    end

    A <-->|JSON-RPC Stdio| B
    B --> C1
    B --> C2
    B --> C3

πŸ“Š Production Benchmarks Scorecard

Metric

nexus-serena-mcp

Standard Regex / Grep

Improvement

Symbol Resolution Speed

< 12ms

~ 180ms

15x Faster

Refactoring Accuracy

100% AST Match

74% (Collisions)

+26% Safety

Memory Footprint

< 14MB

> 120MB

88% Lower

External Dependencies

0 (Stdlib Only)

15+ Packages

Zero Bloat


πŸš€ Quick Start & Setup Guide

VS Code & Claude Code Setup

Add nexus-serena-mcp to your MCP configuration file (mcp.json or claude_desktop_config.json):

{
  "mcpServers": {
    "nexus-serena-mcp": {
      "command": "python3",
      "args": ["path/to/nexus_serena_mcp.py"]
    }
  }
}

Cursor & Windsurf Setup

Go to Settings -> MCP Servers -> Add New MCP Server:

  • Name: nexus-serena-mcp

  • Type: command

  • Command: python3 path/to/nexus_serena_mcp.py

Codex & Antigravity Setup

Run via CLI or embed into agent pipeline:

python3 nexus_serena_mcp.py --self-test

πŸ›οΈ NexusVibe AI Tech 4-Pillar Ecosystem

Repository

Focus Area

Key Capabilities

cloud-ops-mcp

Cloud Infrastructure & Operations

AWS/GCP provisioning, log analysis, deployment automation

code-context-mcp

Codebase Indexing & Context

AST parsing, dependency graph analysis, real-time code search

agent-memory-mcp

Persistent Agent Memory

Entity extraction, graph storage, vector search, multi-session state

nexus-serena-mcp

IDE Toolkit & Live Docs

Symbol AST lookup, surgical refactoring, docstrings, project onboarding


Available Tools

5 tools
find_symbol_definitionC

Locate symbol definitions in AST

Inputs: symbol (required), path.

find_symbol_referencesC

Find symbol usage references

Inputs: symbol (required), path.

project_onboarding_memoryD

Analyze repository structural memory

Inputs: root_path.

resolve_library_docsD

Resolve docstrings for modules

Inputs: library_name (required), symbol_name.

surgical_replace_symbolC

Surgically refactor symbol

Inputs: file_path (required), new_symbol (required), old_symbol (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 5 tools

    Disambiguation4/5

    The first three tools are clearly distinct (definition, references, refactor), and resolve_library_docs is separate. project_onboarding_memory is the only vague one, as it is unclear how it differs from broader repository analysis or symbol lookup.

    Naming Consistency3/5

    Most names use snake_case, but the verb patterns are mixed: find_* and resolve_* are clear verb_noun forms, while surgical_replace_symbol uses an adjective and project_onboarding_memory is a noun phrase. This makes the convention inconsistent, though still readable.

    Tool Count5/5

    Five tools is a well-scoped set for a focused code-intelligence/refactoring server. Each tool appears to target a distinct operation, so the count is appropriate.

    Completeness3/5

    The surface covers definition lookup, reference search, symbol replacement, docs resolution, and repo memory. However, common code-intelligence operations like listing symbols, getting file contents, diagnostics, or rename previews are missing, leaving notable gaps for agents.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides a semantic understanding of your codebase by parsing with tree-sitter and building a graph of symbols and dependencies. Enables AI assistants to navigate code, analyze changes, and discover architecture using 18 tools with minimal context overhead.
      38 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLM agents to efficiently understand and navigate a codebase by providing semantic search over symbols and a reference graph, replacing expensive grep/glob calls with structured tools like definition lookup, caller/callee queries, and change-impact analysis.
      19 PyPI
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Indexes a codebase into a symbol-level graph and exposes tools for finding symbols, querying relationships, and assessing impact, letting AI coding agents answer structural questions in a single call within a token budget.
      128 npm
      4
      Apache 2.0