Files
theia-code-os/packages/ai-mcp.disabled
mawkone 8bb5110148
Some checks failed
Playwright Tests / Playwright Tests (ubuntu-22.04, Node.js 22.x) (push) Has been cancelled
3PP License Check / 3PP License Check (11, 22.x, ubuntu-22.04) (push) Has been cancelled
Publish packages to NPM / Perform Publishing (push) Has been cancelled
deploy: current vibn theia state
Made-with: Cursor
2026-02-27 12:01:08 -08:00
..
2026-02-27 12:01:08 -08:00
2026-02-27 12:01:08 -08:00
2026-02-27 12:01:08 -08:00
2026-02-27 12:01:08 -08:00
2026-02-27 12:01:08 -08:00


theia-ext-logo

ECLIPSE THEIA - AI MCP EXTENSION


Description

The AI MCP package provides an integration that allows users to start and use MCP servers to provide additional tool functions to LLMs, e.g. search or file access (outside of the workspace).

Features

  • Offers the framework to add/remove and start/stop MCP servers
  • Use tool functions provided by MCP servers in prompt templates

Commands

  • Include @theia/ai-mcp-ui to gain access to the start and stop MCP sever commands.

Configuration

To configure MCP servers, include @theia/mcp-ui or bind the included mcp-preferences.

Afterwards, open the preferences and add entries to the MCP Servers Configuration section. Each server requires a unique identifier (e.g., "brave-search" or "filesystem") and configuration details such as the command, arguments, optional environment variables, and autostart (true by default).

"autostart" (true by default) will automatically start the respective MCP server whenever you restart your Theia application. In your current session, however, you'll still need to manually start it using the "MCP: Start MCP Server" command.

Example Configuration:

{
    "ai-features.mcp.mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-memory"
            ],
            "autostart": false
          },
          "brave-search": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-brave-search"
            ],
            "env": {
              "BRAVE_API_KEY": "YOUR_API_KEY"
            }
          },
          "filesystem": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-filesystem",
              "ABSOLUTE_PATH_TO_ALLOWED_DIRECTORY",
            ]
          },
          "git": {
            "command": "uv",
            "args": [
              "--directory",
              "/path/to/repo",
              "run",
              "mcp-server-git"
            ]
          },
          "git2": {
            "command": "uvx",
            "args": [
              "mcp-server-git",
              "--repository",
              "/path/to/otherrepo"
            ]
          }
    }
}

Example prompt (for search)

~{mcp_brave-search_brave_web_search}

Example User query

Search the internet for XYZ

More Information

Theia AI MCP UI README User documentation on MCP in the Theia IDE List of available MCP servers

Additional Information

License

Trademark

"Theia" is a trademark of the Eclipse Foundation https://www.eclipse.org/theia