Language MCP server
Exposes a language server to AI clients so they can get definitions, references, diagnostics, hovers, and rename symbols in a codebase.
Also known as isaacphi/mcp-language-server
- Stars
- 1,618
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Mar 1, 2026
- License
- BSD-3-Clause
What is Language MCP?
Language exposes a language server to AI clients so they can get definitions, references, diagnostics, hovers, and rename symbols in a codebase. It exposes 6 tools, such as definition, references, diagnostics.
Summary generated from the project's README
About Language MCP server
Navigating complex codebases through an AI client is made possible by connecting language servers to large language models. This server acts as a bridge, allowing an AI to use semantic tools like definitions, references, and diagnostics directly within your development environment. It works by wrapping existing language servers that communicate over stdio, such as gopls for Go, rust-analyzer for Rust, pyright for Python, typescript-language-server for TypeScript, or clangd for C/C++.
To use this, you install the server via Go and configure your MCP client, such as Claude Desktop, with the path to your workspace and the specific language server executable. The server provides specialized tools including rename_symbol for project-wide changes and edit_file for precise, line-based text modifications. This setup enables the AI to understand the structure of your code rather than just reading raw text files.
What you can do with it
- 1Locate symbol definitionsAsk the AI to find the complete source code for a specific function or type.
- 2Identify code usagesRequest a list of every place a specific variable or symbol is referenced in the project.
- 3Perform project-wide renamesInstruct the AI to rename a symbol across the entire codebase to maintain consistency.
- 4Apply precise code editsHave the AI modify specific lines of code using a method that is more reliable than simple search and replace.
Written from the project's README. Every use case is checked against a quote from it.
Language MCP tools 6
Detected from the READMEdefinitionreferencesdiagnosticshoverrename_symboledit_file
| definition | — | |
| references | — | |
| diagnostics | — | |
| hover | — | |
| rename_symbol | — | |
| edit_file | — |
Configuration
LOG_LEVEL
| Name | Description | |
|---|---|---|
| LOG_LEVEL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableisaacphi/mcp-language-server is public and reachablegithub.com/isaacphi/mcp-language-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)BSD-3-Clausespdx.org/licenses/BSD-3-Clause.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-03-01github.com/isaacphi/mcp-language-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMCP Language Server
This is an MCP server that runs and exposes a language server to LLMs. Not a language server for MCP, whatever that would be.
Demo
mcp-language-server helps MCP enabled clients navigate codebases more easily by giving them access semantic tools like get definition, references, rename, and diagnostics.

Setup
- Install Go: Follow instructions at https://golang.org/doc/install
- Install or update this server:
go install github.com/isaacphi/mcp-language-server@latest - Install a language server: follow one of the guides below
- Configure your MCP client: follow one of the guides below
<p><strong>Note</strong>:</p>
<ul>
<li>Replace <code>/path/to/your/clangd_binary</code> with the actual path to your clangd executable.</li>
<li><code>--compile-commands-dir</code> should point to the directory containing your <code>compile_commands.json</code> file (e.g., <code>./build</code>, <code>./cmake-build-debug</code>).</li>
<li>Ensure <code>compile_commands.json</code> is generated for your project for clangd to work effectively.</li>
</ul>
Tools
definition: Retrieves the complete source code definition of any symbol (function, type, constant, etc.) from your codebase.references: Locates all usages and references of a symbol throughout the codebase.diagnostics: Provides diagnostic information for a specific file, including warnings and errors.hover: Display documentation, type hints, or other hover information for a given location.rename_symbol: Rename a symbol across a project.edit_file: Allows making multiple text edits to a file based on line numbers. Provides a more reliable and context-economical way to edit files compared to search and replace based edit tools.
About
This codebase makes use of edited code from gopls to handle LSP communication. See ATTRIBUTION for details. Everything here is covered by a permissive BSD style license.
mcp-go is used for MCP communication. Thank you for your service.
This is beta software. Please let me know by creating an issue if you run into any problems or have suggestions of any kind.
Contributing
Please keep PRs small and open Issues first for anything substantial. AI slop O.K. as long as it is tested, passes checks, and doesn't smell too bad.
Setup
Clone the repo:
git clone https://github.com/isaacphi/mcp-language-server.git
cd mcp-language-server
A justfile is included for convenience:
just -l
Available recipes:
build # Build
check # Run code audit checks
fmt # Format code
generate # Generate LSP types and methods
help # Help
install # Install locally
snapshot # Update snapshot tests
test # Run tests
Configure your Claude Desktop (or similar) to use the local binary:
{
"mcpServers": {
"language-server": {
"command": "/full/path/to/your/clone/mcp-language-server/mcp-language-server",
"args": [
"--workspace",
"/path/to/workspace",
"--lsp",
"language-server-executable"
],
"env": {
"LOG_LEVEL": "DEBUG"
}
}
}
}
Rebuild after making changes.
Logging
Setting the LOG_LEVEL environment variable to DEBUG enables verbose logging to stderr for all components including messages to and from the language server and the language server's logs.
LSP interaction
internal/lsp/methods.gocontains generated code to make calls to the connected language server.internal/protocol/tsprotocol.gocontains generated code for LSP types. I borrowed this fromgopls's source code. Thank you for your service.- LSP allows language servers to return different types for the same methods. Go doesn't like this so there are some ugly workarounds in
internal/protocol/interfaces.go.
Local Development and Snapshot Tests
There is a snapshot test suite that makes it a lot easier to try out changes to tools. These run actual language servers on mock workspaces and capture output and logs.
You will need the language servers installed locally to run them. There are tests for go, rust, python, and typescript.
integrationtests/
├── tests/ # Tests are in this folder
├── snapshots/ # Snapshots of tool outputs
├── test-output/ # Gitignored folder showing the final state of each workspace and logs after each test run
└── workspaces/ # Mock workspaces that the tools run on
To update snapshots, run UPDATE_SNAPSHOTS=true go test ./integrationtests/...
Language MCP questions
What tools does Language MCP provide?
It exposes 6 tools, including definition, references, diagnostics, hover, rename_symbol.
What tools does mcp-language-server provide?
It provides definition, references, diagnostics, hover, rename_symbol, and edit_file tools.
Which language servers are supported?
It has tested guides for gopls, rust-analyzer, pyright, typescript-language-server, and clangd, and should work with other stdio-based servers.
How do I connect a language server?
Pass the workspace path with --workspace and the language server command with --lsp; arguments after -- go to the language server.