Skip to main content
Glama

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 document

    • Takes languageId, filePath, content, line, and character as required parameters

  • get_completions: Get completion suggestions for a position in a document

    • Takes languageId, filePath, content, line, and character as required parameters

  • get_diagnostics: Get diagnostic information for a document

    • Takes languageId, filePath, and content as required parameters

Related MCP server: VSCode LSP MCP Server

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

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 inspector

The Inspector will provide a URL to access debugging tools in your browser.

Available Tools

3 tools
get_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

    B3.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      40
      29 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      1
      MIT