nexus-serena-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nexus-serena-mcp Find all references to parse_config and rename it to load_settings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
|
| 15x Faster |
Refactoring Accuracy |
|
| +26% Safety |
Memory Footprint |
|
| 88% Lower |
External Dependencies |
|
| 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-mcpType:
commandCommand:
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 toolsfind_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Codebase intelligence for AI agents β dead code, blast radius, ownership.
Give your AI agent a persistent map of your project's structure, dependencies, and bugs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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 PyPI4MIT
- FlicenseNot gradedqualityBmaintenanceProvides efficient code navigation and graph-based analysis for AI agents, enabling symbol resolution, callers, implementations, and type schemas with minimal token usage.-
- AlicenseNot gradedqualityBmaintenanceIndexes 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 npm4Apache 2.0