Skip to content
Back to search

BifrostMCP

VSCode Extension with an MCP server that exposes semantic tools like Find Usages and Rename to LLMs

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/biegehydra--bifrostmcp/badge.svg)](/listings/biegehydra--bifrostmcp)

HTML

<a href="/listings/biegehydra--bifrostmcp"><img src="/api/listings/biegehydra--bifrostmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- Step 1. Install [Supergateway](https://github.com/supercorp-ai/supergateway) - Step 2. Add config to cline - Step 3. It will show up red but seems to work fine

Windows Config

{
  "mcpServers": {
    "Bifrost": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "supergateway",
        "--sse",
        "http://localhost:8008/sse"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 600
    }
  }
}

Mac/Linux Config

{
  "mcpServers": {
    "Bifrost": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "http://localhost:8008/sse"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 600
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 309 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.