lsp-mcp

Самый полный MCP-сервер для анализа кода. 22 инструмента, охватывающих навигацию, диагностику, рефакторинг и форматирование. Проверено CI для 7 языков. Создан в строгом соответствии со спецификацией LSP 3.17.

В отличие от типичных мостов MCP-LSP, lsp-mcp поддерживает постоянную сессию языкового сервера — агенты работают с полностью проиндексированным рабочим пространством с диагностикой в реальном времени и пониманием связей между файлами, а не с «холодным» заглушечным процессом, который забывает контекст между вызовами.

Почему lsp-mcp

Related MCP server: LSP MCP

Быстрый старт

{
  "mcpServers": {
    "lsp": {
      "type": "stdio",
      "command": "npx",
      "args": ["blackwell-systems/LSP-MCP", "<language-id>", "<path-to-lsp-binary>", "<lsp-args>"]
    }
  }
}

TypeScript:

{ "args": ["blackwell-systems/LSP-MCP", "typescript", "typescript-language-server", "--stdio"] }

Go:

{ "args": ["blackwell-systems/LSP-MCP", "go", "gopls"] }

Rust:

{ "args": ["blackwell-systems/LSP-MCP", "rust", "rust-analyzer"] }

Поддержка нескольких языков

Каждый из перечисленных ниже языков проходит интеграционное тестирование при каждом запуске CI — start_lsp, open_document, get_diagnostics и get_info_on_location проверяются на реальном бинарном файле языкового сервера:

Инструменты

Для всех инструментов сначала необходимо вызвать start_lsp.

Сессия

Анализ

Навигация

Рефакторинг

Утилиты

Рекомендуемый рабочий процесс агента:

start_lsp(root_dir="/your/project")
open_document(file_path=..., language_id=...)
get_diagnostics()                          # whole project, no file_path
get_info_on_location(...) / get_references(...)
close_document(...)

Идентификаторы языков: typescript, typescriptreact, javascript, javascriptreact, python, go, rust, java, c, cpp, php

Ресурсы

Ресурсы диагностики поддерживают подписки в реальном времени — сервер отправляет notifications/resources/updated при изменении диагностики.

Соответствие LSP 3.17

lsp-mcp реализован непосредственно в соответствии со спецификацией LSP 3.17 и проверен с помощью интеграционного тестирования на реальных языковых серверах. Покрытие включает:

• Полный жизненный цикл (initialize → initialized → shutdown) с корректной обработкой SIGINT/SIGTERM

• Протокол прогресса — определение готовности рабочего пространства ожидает завершения всех токенов $/progress перед отправкой ссылок

• Запросы, инициированные сервером (workspace/configuration, window/workDoneProgress/create, динамическая регистрация) — все корректно обрабатываются, разблокируя серверы, которые ожидают загрузки рабочего пространства на основе этих ответов

• Корректное формирование JSON-RPC, обработка кодов ошибок и нормализация формы ответа для наведения, автодополнения, действий кода и диагностики

См. docs/lsp-conformance.md для получения полной матрицы покрытия методов и ссылок на разделы спецификации.

Расширения

Языковые расширения добавляют инструменты, подсказки и обработчики ресурсов, которые автоматически загружаются по идентификатору языка при запуске.

Чтобы добавить расширение, создайте src/extensions/<language-id>.ts, реализующий любое подмножество getToolHandlers, getToolDefinitions, getResourceHandlers, getSubscriptionHandlers, getPromptDefinitions и getPromptHandlers. Все функции имеют пространство имен по идентификатору языка.

Разработка

git clone https://github.com/blackwell-systems/LSP-MCP.git
cd LSP-MCP && npm install && npm run build
npm test                   # all unit test suites
npm run test:multi-lang    # 7-language integration test (requires language servers)

Покрытие: ~76% операторов, ~86% функций. Для проверки трафика MCP: claude --mcp-debug.

Лицензия

MIT