LSP

🚀 LSP-MCP Server

The LSP-MCP Server is a multi - language development platform that integrates the Language Server Protocol (LSP) and the Model Context Protocol (MCP) to provide developers with powerful code management and intelligent code - hinting capabilities.

🚀 Quick Start

📦 Installation

1. Download the installation package: Obtain the binary files for the target language from the official repository.
2. Configure environment variables: Add the path of the LSP - MCP executable file to the system's PATH environment variable.
3. Start the server:

   npx tritlo/lsp-mcp <LANGUAGE> <LSP_EXECUTABLE_PATH> <MCP_ENDPOINT>
   

   Here, <LANGUAGE> is the target language (e.g., haskell), <LSP_EXECUTABLE_PATH> is the path to the LSP implementation's executable file, and <MCP_ENDPOINT> is the network address of the MCP service.

💻 Common Commands

• Start the server:

  npx tritlo/lsp-mcp haskell /path/to/haskell-language-server-wrapper lsp
  

• Stop the server: Use Ctrl + C or send a SIGINT signal.
• View logs: Specify the log output path through the configuration file or enable debug mode at runtime.

✨ Features

🛠️ Developer Tools

Diagnostic Tools

1. Get error information:

   lsp-mcp-tool get-diagnostics --file /path/to/file
   

2. Subscribe to diagnostic updates:

   lsp-mcp-tool subscribe resource/lsp-diagnostics://
   

Hover Hint Tools

1. Query code information:

   lsp-mcp-tool info-on-location --file /path/to/file --line 42 --column 10 --language_id haskell
   

2. Subscribe to hover hint updates: Real - time subscription is not currently supported.

Completion Tools

1. Get code completion suggestions:

   lsp-mcp-tool get-completions --file /path/to/file --line 42 --column 10 --language_id haskell
   

2. Subscribe to completion updates: Real - time subscription is not currently supported.

🌐 Resource Access

Resource URI Formats

• Diagnostic resources:

  lsp-diagnostics://
  lsp-diagnostics:///path/to/file
  

• Hover hint resources:

  lsp-hover:///path/to/file?line={line}&column={column}&language_id={language_id}
  

• Completion resources:

  lsp-completions:///path/to/file?line={line}&column={column}&language_id={language_id}
  

Resource Subscription

1. List available resources: Use the MCP resources/list endpoint.
2. Subscribe to diagnostic updates: Use the MCP resources/subscribe endpoint.

⚙️ Extension Mechanisms

Plugin Development

• Create a plugin directory:

  lsp-mcp-plugin create my_plugin
  

• Register a plugin:

  lsp-mcp-plugin register ./my_plugin
  

Adapter Development

• Write adapter code: Implement the LanguageAdapter interface.
• Register an adapter:

  lsp-mcp-adapter register MyAdapter
  

🛠️ Troubleshooting

🤔 Common Issues

1. Unable to start the server: Check if the environment variables and dependencies are configured correctly.
2. Missing diagnostic information: Confirm that the target file is loaded and the language adapter is enabled.
3. Abnormal completion function: Verify the connectivity of the MCP endpoint and the version of the LSP implementation.

🐞 Debugging Methods

1. Log analysis:

   lsp-mcp-server --debug > debug.log 2>&1
   

2. Configuration file check: Ensure that the parameters in config.json are set correctly.
3. Dependency verification: Confirm that all necessary libraries and tools are installed correctly.

📄 License

The LSP - MCP Server is licensed under the MIT License, which allows users to freely use, modify, and distribute the code. Please refer to the LICENSE file in the project repository for specific license details.

📚 Documentation Extension

🤝 Contribution Guidelines

1. Submit issues: Report bugs or propose suggestions by submitting an issue on GitHub.
2. Write documentation: Add documentation in Chinese or other languages to the project.
3. Participate in development: Fork the code repository, clone it, and then develop and test new features.

📞 Contact Information

• Email support: support@lsp - mcp.com
• Community forum: https://discussions.lsp - mcp.com

The LSP - MCP Server provides developers with an efficient and intelligent code management environment through its powerful features and flexible extension mechanisms. Whether it's diagnostic tools, hover hints, or code completion functions, they can significantly improve development efficiency.