diff --git a/documentation/docs/mcp/cognee-mcp.md b/documentation/docs/mcp/cognee-mcp.md index f39454f9308..1aac1e41715 100644 --- a/documentation/docs/mcp/cognee-mcp.md +++ b/documentation/docs/mcp/cognee-mcp.md @@ -7,7 +7,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; -This tutorial covers how to add the [Cognee MCP Server](https://github.com/topoteretes/cognee) as a Goose extension to enable knowledge graph memory capabilities, connecting to over 30 data sources for enhanced context and retrieval. +This tutorial covers how to add the [Cognee MCP Server](https://github.com/topoteretes/cognee/tree/main/cognee-mcp) as a Goose extension to enable knowledge graph memory capabilities, connecting to over 30 data sources for enhanced context and retrieval. :::tip TLDR **Command** @@ -17,7 +17,6 @@ uv --directory /path/to/cognee-mcp run python src/server.py **Environment Variables** ``` LLM_API_KEY: -EMBEDDING_API_KEY: ``` ::: @@ -34,7 +33,7 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on ```bash # Clone and install Cognee git clone https://github.com/topoteretes/cognee -cd cognee-mcp +cd cognee/cognee-mcp uv sync --dev --all-extras --reinstall # On Linux, install additional dependencies @@ -153,7 +152,7 @@ goose configure 8. Add the required environment variables: :::info -You'll need OpenAI API keys for both LLM and embedding models. [Get your API keys here](https://platform.openai.com/api-keys). +You'll need an API key for your LLM provider. By default, this is an [OpenAI API key](https://platform.openai.com/api-keys). ::: ```sh @@ -188,15 +187,6 @@ You'll need OpenAI API keys for both LLM and embedding models. [Get your API key │ ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪ │ ◇ Add another environment variable? - │ Yes - │ - ◇ Environment variable name: - │ EMBEDDING_API_KEY - │ - ◇ Environment variable value: - │ ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪ - │ - ◇ Add another environment variable? │ No // highlight-end └ Added Cognee extension @@ -205,6 +195,10 @@ You'll need OpenAI API keys for both LLM and embedding models. [Get your API key +:::info +See the [Cognee MCP documentation](https://docs.cognee.ai/how-to-guides/deployment/mcp) for supported configuration options. +::: + ## Example Usage Cognee provides knowledge graph memory capabilities for Goose, allowing it to remember and connect information across conversations and documents. diff --git a/documentation/docs/mcp/mbot-mcp.md b/documentation/docs/mcp/mbot-mcp.md index 4a0b07613d6..7ca8922362c 100644 --- a/documentation/docs/mcp/mbot-mcp.md +++ b/documentation/docs/mcp/mbot-mcp.md @@ -13,18 +13,12 @@ import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller'; This tutorial will get you started with [deemkeen's MQTT MCP server](https://github.com/deemkeen/mbotmcp) for the [MakeBlock mbot2 rover](https://www.makeblock.com/products/buy-mbot2), and outline some code changes we made along the way. :::tip TLDR - - - [Launch the installer](goose://extension?cmd=/path/to/java&arg=-jar&arg=/path/to/mbotmcp-0.0.1-SNAPSHOT.jar&name=mbot2&description=mbot2&env=MQTT_SERVER_URI%3Dtcp://1.2.3.4:1883&env=MQTT_USERNAME%3Dyour_username&env=MQTT_PASSWORD%3Dyour_password) - - **Command** ```sh /path/to/java -jar /path/to/mbotmcp-0.0.1-SNAPSHOT.jar ``` - - - **Environment Variable** + + **Environment Variables** ``` MQTT_SERVER_URI: tcp://1.2.3.4:1883 MQTT_PASSWORD: @@ -35,20 +29,6 @@ This tutorial will get you started with [deemkeen's MQTT MCP server](https://git ## Configuration - - - 1. Run the `configure` command: ```sh diff --git a/documentation/static/servers.json b/documentation/static/servers.json index d91e3e156c6..e30f7b56ed9 100644 --- a/documentation/static/servers.json +++ b/documentation/static/servers.json @@ -130,13 +130,20 @@ { "id": "cognee-mcp", "name": "Cognee", - "description": "Knowledge graph and cognitive AI capabilities", - "command": "uvx cognee-mcp", + "description": "Knowledge graph and cognitive AI capabilities (requires local server setup)", + "command": "uv --directory /path/to/cognee-mcp run python src/server.py", "link": "https://github.com/topoteretes/cognee", - "installation_notes": "Install using uvx package manager.", + "installation_notes": "This is a local extension. You must first clone and install the Cognee MCP server locally before using this extension. Update the placeholder path before running the 'goose session' command.", "is_builtin": false, - "endorsed": false, - "environmentVariables": [] + "endorsed": true, + "show_install_link": false, + "environmentVariables": [ + { + "name": "LLM_API_KEY", + "description": "API key for your LLM provider", + "required": true + } + ] }, { "id": "computercontroller", @@ -298,10 +305,11 @@ { "id": "jetbrains", "name": "JetBrains", - "description": "Integrate Goose with any JetBrains IDE", - "command": "npx -y @jetbrains/mcp-proxy", + "description": "Integrate with any JetBrains IDE (requires local setup, dependent on your IDE version)", + "url": "http://localhost:/sse", + "type": "remote", "link": "https://github.com/JetBrains/mcp-jetbrains", - "installation_notes": "Install using npx package manager. Requires the MCP Server plugin to be installed in your JetBrains IDE.", + "installation_notes": "IDE v2025.2 and later: Enable SSE configuration from Settings > Tools > MCP Server, then update the placeholder SSE URL in the following command. If installing from the link, you must update the URL from the Extensions page before activating the extension. For earlier IDE versions, you must install the MCP Server plugin and use npx package manager to install the extension.", "is_builtin": false, "endorsed": true, "environmentVariables": [] @@ -320,13 +328,30 @@ { "id": "mbot-mcp", "name": "MBot", - "description": "Chatbot and conversational AI integration", - "command": "npx -y mbot-mcp", + "description": "Control a MakeBlock mbot2 rover through MQTT (requires local setup)", + "command": "/path/to/java -jar /path/to/mbotmcp-0.0.1-SNAPSHOT.jar", "link": "https://github.com/deemkeen/mbotmcp", - "installation_notes": "Install using npx package manager.", + "installation_notes": "This is a local extension. You must first download the JAR file from the repository, install Java, and update the placeholder paths before running the 'goose session' command.", "is_builtin": false, "endorsed": false, - "environmentVariables": [] + "show_install_link": false, + "environmentVariables": [ + { + "name": "MQTT_SERVER_URI", + "description": "MQTT server URI (example: tcp://1.2.3.4:1883)", + "required": true + }, + { + "name": "MQTT_USERNAME", + "description": "MQTT username (empty string if no auth required)", + "required": true + }, + { + "name": "MQTT_PASSWORD", + "description": "MQTT password (empty string if no auth required)", + "required": true + } + ] }, { "id": "memory",