Bifrost - VSCode Dev Tools MCP Server

1# Bifrost - VSCode Dev Tools MCP Server
2<a href="https://marketplace.visualstudio.com/items?itemName=ConnorHallman.bifrost-mcp">
3  <img src="https://img.shields.io/visual-studio-marketplace/d/ConnorHallman.bifrost-mcp?label=VSCode%20Extension%20Downloads&cacheSeconds=3600" 
4       alt="VSCode Extension Downloads" 
5       width="250">
6</a>
7 
8This VS Code extension provides a Model Context Protocol (MCP) server that exposes VSCode's powerful development tools and language features to AI tools. It enables advanced code navigation, analysis, and manipulation capabilities when using AI coding assistants that support the MCP protocol.
9 
10![image](https://raw.githubusercontent.com/biegehydra/BifrostMCP/refs/heads/master/src/images/cursor.png)
11 
12## Table of Contents
13- [Features](#features)
14- [Installation/Usage](#usage)
15- [Multi-Project Support](#multiple-project-support)
16- [Available Tools](#available-tools)
17- [Available Commands](#available-commands)
18- [Troubleshooting](#troubleshooting)
19- [Contributing](#contributing)
20- [Debugging](#debugging)
21- [License](#license)
22 
23## Features
24 
25- **Language Server Integration**: Access VSCode's language server capabilities for any supported language
26- **Code Navigation**: Find references, definitions, implementations, and more
27- **Symbol Search**: Search for symbols across your workspace
28- **Code Analysis**: Get semantic tokens, document symbols, and type information
29- **Smart Selection**: Use semantic selection ranges for intelligent code selection
30- **Code Actions**: Access refactoring suggestions and quick fixes
31- **HTTP/SSE Server**: Exposes language features over an MCP-compatible HTTP server
32- **AI Assistant Integration**: Ready to work with AI assistants that support the MCP protocol
33 
34## Usage
35 
36### Installation
37 
381. Install [the extension](https://marketplace.visualstudio.com/items?itemName=ConnorHallman.bifrost-mcp) from the VS Code marketplace
392. Install any language-specific extensions you need for your development
403. Open your project in VS Code
41 
42### Configuration
43 
44The extension will automatically start an MCP server when activated. To configure an AI assistant to use this server:
45 
461. The server runs on port 8008 by default (configurable with `bifrost.config.json`)
472. Configure your MCP-compatible AI assistant to connect to:
48   - SSE endpoint: `http://localhost:8008/sse`
49   - Message endpoint: `http://localhost:8008/message`
50 
51### LLM Rules
52I have also provided sample rules that can be used in .cursorrules files for better results.
53 
54[Example Cursor Rules](https://github.com/biegehydra/BifrostMCP/blob/master/ExampleCursorRules.md)
55 
56[Example MDC Rules](https://github.com/biegehydra/BifrostMCP/blob/master/example.mdc)
57 
58### Cline Installation
59- Step 1. Install [Supergateway](https://github.com/supercorp-ai/supergateway)
60- Step 2. Add config to cline
61- Step 3. It will show up red but seems to work fine
62 
63#### Windows Config
64```json
65{
66  "mcpServers": {
67    "Bifrost": {
68      "command": "cmd",
69      "args": [
70        "/c",
71        "npx",
72        "-y",
73        "supergateway",
74        "--sse",
75        "http://localhost:8008/sse"
76      ],
77      "disabled": false,
78      "autoApprove": [],
79      "timeout": 600
80    }
81  }
82}
83```
84 
85#### Mac/Linux Config
86```json
87{
88  "mcpServers": {
89    "Bifrost": {
90      "command": "npx",
91      "args": [
92        "-y",
93        "supergateway",
94        "--sse",
95        "http://localhost:8008/sse"
96      ],
97      "disabled": false,
98      "autoApprove": [],
99      "timeout": 600
100    }
101  }
102}
103```
104 
105### Roo Code Installation
106- Step 1: Add the SSE config to your global or project-based MCP configuration
107```json
108{
109  "mcpServers": {
110    "Bifrost": {
111      "url": "http://localhost:8008/sse"
112    }
113  }
114}
115```
116 
117![Screenshot_78](https://github.com/user-attachments/assets/55588c9e-7f88-4830-b87f-184018873ca1)
118 
119Follow this video to install and use with cursor
120 
121#### FOR NEW VERSIONS OF CURSOR, USE THIS CODE
122```json
123{
124  "mcpServers": {
125    "Bifrost": {
126      "url": "http://localhost:8008/sse"
127    }
128  }
129}
130```
131 
132## Multiple Project Support
133 
134When working with multiple projects, each project can have its own dedicated MCP server endpoint and port. This is useful when you have multiple VS Code windows open or are working with multiple projects that need language server capabilities.
135 
136### Project Configuration
137 
138Create a `bifrost.config.json` file in your project root:
139 
140```json
141{
142    "projectName": "MyProject",
143    "description": "Description of your project",
144    "path": "/my-project",
145    "port": 5642
146}
147```
148 
149The server will use this configuration to:
150- Create project-specific endpoints (e.g., `http://localhost:5642/my-project/sse`)
151- Provide project information to AI assistants
152- Use a dedicated port for each project
153- Isolate project services from other running instances
154 
155### Example Configurations
156 
1571. Backend API Project:
158```json
159{
160    "projectName": "BackendAPI",
161    "description": "Node.js REST API with TypeScript",
162    "path": "/backend-api",
163    "port": 5643
164}
165```
166 
1672. Frontend Web App:
168```json
169{
170    "projectName": "FrontendApp",
171    "description": "React frontend application",
172    "path": "/frontend-app",
173    "port": 5644
174}
175```
176 
177### Port Configuration
178 
179Each project should specify its own unique port to avoid conflicts when multiple VS Code instances are running:
180 
181- The `port` field in `bifrost.config.json` determines which port the server will use
182- If no port is specified, it defaults to 8008 for backwards compatibility
183- Choose different ports for different projects to ensure they can run simultaneously
184- The server will fail to start if the configured port is already in use, requiring you to either:
185  - Free up the port
186  - Change the port in the config
187  - Close the other VS Code instance using that port
188 
189### Connecting to Project-Specific Endpoints
190 
191Update your AI assistant configuration to use the project-specific endpoint and port:
192 
193```json
194{
195  "mcpServers": {
196    "BackendAPI": {
197      "url": "http://localhost:5643/backend-api/sse"
198    },
199    "FrontendApp": {
200      "url": "http://localhost:5644/frontend-app/sse"
201    }
202  }
203}
204```
205 
206### Backwards Compatibility
207 
208If no `bifrost.config.json` is present, the server will use the default configuration:
209- Port: 8008
210- SSE endpoint: `http://localhost:8008/sse`
211- Message endpoint: `http://localhost:8008/message`
212 
213This maintains compatibility with existing configurations and tools.
214 
215## Available Tools
216 
217The extension provides access to many VSCode language features including:
218 
219* **find\_usages**: Locate all symbol references.
220* **go\_to\_definition**: Jump to symbol definitions instantly.
221* **find\_implementations**: Discover implementations of interfaces/abstract methods.
222* **get\_hover\_info**: Get rich symbol docs on hover.
223* **get\_document\_symbols**: Outline all symbols in a file.
224* **get\_completions**: Context-aware auto-completions.
225* **get\_signature\_help**: Function parameter hints and overloads.
226* **get\_rename\_locations**: Safely get location of places to perform a rename across the project.
227* **rename**: Perform rename on a symbol
228* **get\_code\_actions**: Quick fixes, refactors, and improvements.
229* **get\_semantic\_tokens**: Enhanced highlighting data.
230* **get\_call\_hierarchy**: See incoming/outgoing call relationships.
231* **get\_type\_hierarchy**: Visualize class and interface inheritance.
232* **get\_code\_lens**: Inline insights (references, tests, etc.).
233* **get\_selection\_range**: Smart selection expansion for code blocks.
234* **get\_type\_definition**: Jump to underlying type definitions.
235* **get\_declaration**: Navigate to symbol declarations.
236* **get\_document\_highlights**: Highlight all occurrences of a symbol.
237* **get\_workspace\_symbols**: Search symbols across your entire workspace.
238 
239## Requirements
240 
241- Visual Studio Code version 1.93.0 or higher
242- Appropriate language extensions for the languages you want to work with (e.g., C# extension for C# files)
243 
244### Available Commands
245 
246- `Bifrost MCP: Start Server` - Manually start the MCP server on port 8008
247- `Bifrost MCP: Start Server on port` - Manually start the MCP server on specified port
248- `Bifrost MCP: Stop Server` - Stop the running MCP server
249- `Bifrost MCP: Open Debug Panel` - Open the debug panel to test available tools
250 
251![image](https://raw.githubusercontent.com/biegehydra/BifrostMCP/refs/heads/master/src/images/commands.png)
252 
253## Star History
254 
255[![Star History Chart](https://api.star-history.com/svg?repos=biegehydra/BifrostMCP&type=Date)](https://star-history.com/#biegehydra/BifrostMCP&Date)
256 
257## Example Tool Usage
258 
259### Find References
260```json
261{
262  "name": "find_usages",
263  "arguments": {
264    "textDocument": {
265      "uri": "file:///path/to/your/file"
266    },
267    "position": {
268      "line": 10,
269      "character": 15
270    },
271    "context": {
272      "includeDeclaration": true
273    }
274  }
275}
276```
277 
278### Workspace Symbol Search
279```json
280{
281  "name": "get_workspace_symbols",
282  "arguments": {
283    "query": "MyClass"
284  }
285}
286```
287 
288## Troubleshooting
289 
290If you encounter issues:
291 
2921. Ensure you have the appropriate language extensions installed for your project
2932. Check that your project has loaded correctly in VSCode
2943. Verify that port 8008 is available on your system
2954. Check the VSCode output panel for any error messages
296 
297## Contributing
298Here are [Vscodes commands](https://github.com/microsoft/vscode-docs/blob/main/api/references/commands.md?plain=1) if you want to add additional functionality go ahead. I think we still need rename and a few others.
299Please feel free to submit issues or pull requests to the [GitHub repository](https://github.com/biegehydra/csharplangmcpserver).
300 
301`vsce package`
302 
303## Debugging
304Use the `MCP: Open Debug Panel` command
305![image](https://raw.githubusercontent.com/biegehydra/BifrostMCP/refs/heads/master/src/images/debug_panel.png)
306 
307## License
308 
309This extension is licensed under the APGL-3.0 License.
310