@theia/ai-mcp
v1.59.0
Published
Theia - MCP Integration
Downloads
1,605
Maintainers
Keywords
Readme
Model Context Server (MCP) Integration
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
- Add MCP servers via settings.json
- Start and stop MCP servers.
- Use tool functions provided by MCP servers in prompt templates
Commands
Start MCP Server
- Command ID:
mcp.startserver
- Label:
MCP: Start MCP Server
- Functionality: Allows you to start a MCP server by selecting from a list of configured servers.
Stop MCP Server
- Command ID:
mcp.stopserver
- Label:
MCP: Stop MCP Server
- Functionality: Allows you to stop a running MCP server by selecting from a list of currently running servers.
Usage
Starting a MCP Server:
- Use the command palette to invoke
MCP: Start MCP Server
. - A quick pick menu will appear with a list of configured MCP servers.
- Select a server to start.
- Use the command palette to invoke
Stopping a MCP Server:
- Use the command palette to invoke
MCP: Stop MCP Server
. - A quick pick menu will display a list of currently running MCP servers.
- Select a server to stop.
- Use the command palette to invoke
Using provided tool functions
- Only functions of started MCP servers can be used
- Open a prompt template and add the added tool functions
- Type '~{' to open the auto completion
Configuration
To configure MCP servers, 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
User documentation on MCP in the Theia IDE List of available MCP servers