/ Verzeichnis / Playground / mcp-language-server
● Community isaacphi ⚡ Sofort

mcp-language-server

von isaacphi · isaacphi/mcp-language-server

Give your agent real LSP semantics — go-to-definition, references, rename, diagnostics — via any stdio language server.

isaacphi/mcp-language-server is a Go binary that bridges MCP to any stdio LSP (gopls, rust-analyzer, pyright, typescript-language-server, clangd). Agents get symbol-accurate operations instead of text-search approximations.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

language-server.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "language-server": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/isaacphi/mcp-language-server"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "language-server": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/isaacphi/mcp-language-server"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "language-server": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/isaacphi/mcp-language-server"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "language-server": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/isaacphi/mcp-language-server"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "language-server",
      "command": "TODO",
      "args": [
        "See README: https://github.com/isaacphi/mcp-language-server"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "language-server": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/isaacphi/mcp-language-server"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add language-server -- TODO 'See README: https://github.com/isaacphi/mcp-language-server'

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: mcp-language-server

How to rename a symbol safely across a repo

👤 Polyglot devs using agents ⏱ ~15 min intermediate

Wann einsetzen: You want a rename that understands scope, not a find-replace.

Voraussetzungen
  • Go installed — brew install go
  • The LSP for your language — gopls: go install golang.org/x/tools/gopls@latest; pyright: pip install pyright; etc.
  • Install the MCP — go install github.com/isaacphi/mcp-language-server@latest
Ablauf
  1. Start the MCP pointed at your workspace + LSP
    Add MCP config: command=mcp-language-server, args=['--workspace','.','--lsp','gopls'].✓ Kopiert
    → Tools appear
  2. Find references first
    references for symbol 'LegacyAuth' in file auth.go.✓ Kopiert
    → Precise cross-repo references
  3. Rename
    rename_symbol 'LegacyAuth' -> 'Auth' at the definition site.✓ Kopiert
    → All callsites updated correctly

Ergebnis: Semantically-correct rename across the repo.

Fallstricke
  • Agent falls back to text find-replace when the tool fails — Verify diagnostics after rename — compile errors mean the LSP refused and the agent cheated
Kombinieren mit: github

How to let the agent navigate like you do in an IDE

👤 Agent users tired of re-grepping ⏱ ~10 min beginner

Wann einsetzen: Agent keeps reading whole files to find one function.

Ablauf
  1. Query definition
    definition for 'computeTax' in src/billing.ts.✓ Kopiert
    → Exact file:line location
  2. Pull diagnostics
    diagnostics for the current file.✓ Kopiert
    → Red squigglies from the LSP

Ergebnis: Agent navigates like an IDE user.

Fallstricke
  • LSP not initialized — slow first call — Warm up with a list of files in the workspace; pyright especially is slow to index
Kombinieren mit: contextplus

How to run multiple LSPs for a polyglot monorepo

👤 Devs on Go+TS+Python monorepos ⏱ ~25 min advanced

Wann einsetzen: You want semantic ops in every language.

Ablauf
  1. Register one MCP per LSP
    Add 3 MCP entries: lsp-go (gopls), lsp-ts (tsserver), lsp-py (pyright), each scoped to its workspace subfolder.✓ Kopiert
    → 3 sets of language-specific tools
  2. Use them in turn
    For TypeScript questions use lsp-ts:definition; for Go use lsp-go:definition.✓ Kopiert
    → Correct semantics per language

Ergebnis: Semantically-aware navigation across all languages.

Fallstricke
  • Agent forgets which MCP handles which language — Rename tool prefixes descriptively and mention in your project memory

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

language-server + contextplus

Combine LSP navigation with semantic/embedding search for broader queries

Use language-server's references for exact usages of computeTax, then contextplus semantic search to find conceptually-related functions.✓ Kopiert
language-server + github

Rename + commit + PR

Rename LegacyAuth to Auth via the LSP, commit to a new branch, open a PR.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
definition file: str, symbol_or_position Jump to declaration free (local LSP)
references file: str, symbol_or_position Find usages free
diagnostics file: str Check errors/warnings free
hover file, position Type info / docs for a symbol free
rename_symbol file, position, new_name Safe rename free
edit_file file, edits LSP-validated edit free

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
None — local LSP
Tokens pro Aufruf
Small — LSP responses are compact
Kosten in €
Free
Tipp
Use LSP-backed tools before embedding search — often cheaper and more precise.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Filesystem read/write to the workspace
Credential-Speicherung: None
Datenabfluss: Localhost only; LSP runs in-process
Niemals gewähren: Don't point it at workspaces with secrets — LSPs sometimes index them

Fehlerbehebung

Häufige Fehler und Lösungen

tool returns 'LSP not ready'

First call triggers initialization — retry after 2-5 seconds, or warm up with a hover call.

gopls: 'no packages found'

Point workspace at the module root (where go.mod is), not a subfolder.

Prüfen: go env GOMOD
pyright slow on big repos

Configure pyrightconfig.json to exclude vendored dirs.

rename_symbol reports success but compile still fails

Rename touched a string literal or reflection-based code the LSP can't see. Check grep for the old name.

Alternativen

mcp-language-server vs. andere

AlternativeWann stattdessenKompromiss
Context+You want embedding + memory graph rather than LSP semanticsNot as precise on rename/references
Serena MCPYou want LSP with higher-level refactorsDifferent setup; Python-based

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen