language-server-mcp
The language-server-mcp is a TypeScript-based server that provides language support for code editing via the Model Context Protocol (MCP).
It offers three main capabilities:
Hover Information: Retrieve details for code symbols using
get_hoverCode Completion: Get suggestions at specific positions with
get_completionsDiagnostics: Fetch errors and warnings through
get_diagnostics
Each function requires parameters like languageId, filePath, content, and projectRoot. The server is primarily tested with TypeScript, with theoretical support for Python and potential for additional language integrations.
Theoretically provides language support for Python code editing, though it has only been tested with TypeScript.
Provides language support for TypeScript code editing with features like hover information, code completion, and diagnostics.
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., "@language-server-mcp get hover info for line 15 character 7 in my typescript file"
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.
language-server-mcp MCP Server
A Model Context Protocol (MCP) server providing language support for code editing.
This is a TypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics. It demonstrates core MCP concepts by providing:
Language-specific tools for code analysis and manipulation
Integration with the Model Context Protocol for seamless communication
Features
Language Support
Provides hover information for symbols in code
Offers code completion suggestions
Reports diagnostic information (errors, warnings)
Only tested with typescript, theoretically should support Python. Would love to add additional language servers or be more agnostic if possible.
MCP Integration
Implements the MCP protocol for communication with clients
Exposes language features as MCP tools
Tools
get_hover: Get hover information for a position in a documentTakes languageId, filePath, content, line, and character as required parameters
get_completions: Get completion suggestions for a position in a documentTakes languageId, filePath, content, line, and character as required parameters
get_diagnostics: Get diagnostic information for a documentTakes languageId, filePath, and content as required parameters
Related MCP server: VSCode LSP MCP Server
Development
Install dependencies:
npm installBuild the server:
npm run buildFor development with auto-rebuild:
npm run watchInstallation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"language-server-mcp": {
"command": "/path/to/language-server-mcp/build/index.js"
}
}
}Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspectorThe Inspector will provide a URL to access debugging tools in your browser.
Available Tools
3 toolsget_completionsC
Get completion suggestions for a position in a document
Inputs: character (required), content (required), filePath (required), languageId (required), +2 more.
get_diagnosticsC
Get diagnostic information for a document
Inputs: content (required), filePath (required), languageId (required), projectRoot (required).
get_hoverC
Get hover information for a position in a document
Inputs: character (required), content (required), filePath (required), languageId (required), +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: get_completions provides suggestions, get_diagnostics provides error/warning information, and get_hover provides documentation. There is no overlap or ambiguity between these three core language server operations.
All tools follow a consistent verb_noun pattern with 'get_' prefix and descriptive nouns (completions, diagnostics, hover). The naming is perfectly uniform and predictable throughout the set.
With only 3 tools, the server feels somewhat thin for a language server domain. While these cover fundamental operations, typical language servers would include more capabilities like formatting, references, definitions, or rename operations. The count is borderline minimal.
The tool surface is significantly incomplete for a language server. Missing are essential operations like formatting, finding references, getting definitions, renaming symbols, and code actions. Agents will encounter dead ends when trying to perform common language server tasks beyond the three provided.
Related MCP Connectors
The official Svelte MCP server providing docs and autofixing tools for Svelte development
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…
A MCP server built for developers enabling Git based project management with project and personal…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables LLMs to understand and work with TypeScript APIs they haven't been trained on by providing structured access to TypeScript type definitions and documentation.46MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that exposes Language Server Protocol features to external clients, allowing access to hover information, definitions, completions, references, and rename functionalities.43MIT
- AlicenseAqualityDmaintenanceA lightweight MCP server that provides 40 tools for TypeScript/JavaScript refactoring and code intelligence, directly mapping to TypeScript's tsserver protocol commands for accurate structural changes and workspace analysis.4029 npm3MIT
- AlicenseNot gradedqualityDmaintenanceA standalone MCP server that provides TypeScript type inference and hover information using tsgo, enabling AI agents to get type details, diagnostics, references, and more without needing an editor.1MIT