opencode-mcp 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2025-02-08
+
+### Changed
+
+- Removed opencode self-referencing config from README (it doesn't make sense to add opencode-mcp to opencode itself)
+- Added MCP client configs for VS Code (GitHub Copilot), Cline, Continue, Zed, and Amazon Q
+- Clarified that all environment variables and authentication are optional
+- Added "Compatible MCP Clients" section to README
+- Updated docs/configuration.md with all new client configs
+
 ## [1.0.0] - 2025-02-08
 
 ### Added

package/README.md

@@ -1,8 +1,9 @@
 # opencode-mcp
 
-[![npm version](https://img.shields.io/npm/v/opencode-mcp.svg)](https://www.npmjs.com/package/opencode-mcp)
-[![license](https://img.shields.io/npm/l/opencode-mcp.svg)](https://github.com/AlaeddineMessadi/opencode-mcp/blob/main/LICENSE)
-[![node](https://img.shields.io/node/v/opencode-mcp.svg)](https://nodejs.org/)
+[![npm version](https://img.shields.io/npm/v/opencode-mcp)](https://www.npmjs.com/package/opencode-mcp)
+[![license](https://img.shields.io/github/license/AlaeddineMessadi/opencode-mcp)](https://github.com/AlaeddineMessadi/opencode-mcp/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/opencode-mcp)](https://nodejs.org/)
+[![npm downloads](https://img.shields.io/npm/dm/opencode-mcp)](https://www.npmjs.com/package/opencode-mcp)
 
 An [MCP](https://modelcontextprotocol.io/) server that gives any MCP-compatible client full access to a running [OpenCode](https://opencode.ai/) instance. Manage sessions, send prompts, search files, review diffs, configure providers, control the TUI, and more.
 
@@ -18,6 +19,8 @@ opencode serve
 
 ### 2. Add to your MCP client
 
+Pick your client below. No authentication is needed by default — just add the config and restart your client.
+
 **Claude Desktop** (`claude_desktop_config.json`):
 
 ```json
@@ -63,23 +66,82 @@ claude mcp add opencode -- npx -y opencode-mcp
 }
 ```
 
-**opencode** (`opencode.json`):
+**VS Code — GitHub Copilot** (`settings.json`):
 
 ```json
 {
-  "mcp": {
-    "opencode-mcp": {
+  "github.copilot.chat.mcp.servers": [
+    {
+      "name": "opencode",
       "type": "stdio",
       "command": "npx",
       "args": ["-y", "opencode-mcp"]
     }
+  ]
+}
+```
+
+**Cline** (VS Code extension settings):
+
+```json
+{
+  "mcpServers": {
+    "opencode": {
+      "command": "npx",
+      "args": ["-y", "opencode-mcp"]
+    }
+  }
+}
+```
+
+**Continue** (`.continue/config.json`):
+
+```json
+{
+  "mcpServers": {
+    "opencode": {
+      "command": "npx",
+      "args": ["-y", "opencode-mcp"]
+    }
+  }
+}
+```
+
+**Zed** (`settings.json`):
+
+```json
+{
+  "context_servers": {
+    "opencode": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "opencode-mcp"]
+      }
+    }
   }
 }
 ```
 
+**Amazon Q** (VS Code `settings.json`):
+
+```json
+{
+  "amazon-q.mcp.servers": [
+    {
+      "name": "opencode",
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "opencode-mcp"]
+    }
+  ]
+}
+```
+
 That's it. Your MCP client now has access to the entire OpenCode API.
 
-### Custom server URL or auth
+### Custom server URL or authentication (optional)
+
+By default, the MCP server connects to `http://127.0.0.1:4096` with no authentication. Both username and password are **optional** — auth is only needed if you've enabled it on the OpenCode server side.
 
 If the OpenCode server is on a different host/port or has auth enabled, pass environment variables:
 
@@ -170,11 +232,15 @@ Guided workflow templates:
 
 ## Environment Variables
 
-| Variable | Description | Default |
-|---|---|---|
-| `OPENCODE_BASE_URL` | URL of the OpenCode server | `http://127.0.0.1:4096` |
-| `OPENCODE_SERVER_USERNAME` | HTTP basic auth username | `opencode` |
-| `OPENCODE_SERVER_PASSWORD` | HTTP basic auth password | *(none — auth disabled)* |
+All environment variables are **optional**. You only need to set them if you've changed the defaults on the OpenCode server side.
+
+| Variable | Description | Default | Required |
+|---|---|---|---|
+| `OPENCODE_BASE_URL` | URL of the OpenCode server | `http://127.0.0.1:4096` | No |
+| `OPENCODE_SERVER_USERNAME` | HTTP basic auth username | `opencode` | No |
+| `OPENCODE_SERVER_PASSWORD` | HTTP basic auth password | *(none — auth disabled)* | No |
+
+> **Note:** Authentication is disabled by default. It only activates when `OPENCODE_SERVER_PASSWORD` is set on both the OpenCode server and the MCP server.
 
 ## How It Works
 
@@ -229,6 +295,20 @@ npm run dev      # watch mode
 - [Usage Examples](docs/examples.md) — real workflow examples
 - [Architecture](docs/architecture.md) — system design and data flow
 
+## Compatible MCP Clients
+
+Works with any MCP-compatible client, including:
+
+- [Claude Desktop](https://claude.ai/download)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+- [Cursor](https://cursor.sh/)
+- [Windsurf](https://codeium.com/windsurf)
+- [VS Code (GitHub Copilot)](https://code.visualstudio.com/)
+- [Cline](https://github.com/cline/cline)
+- [Continue](https://continue.dev/)
+- [Zed](https://zed.dev/)
+- [Amazon Q](https://aws.amazon.com/q/developer/)
+
 ## References
 
 - [OpenCode Documentation](https://opencode.ai/docs/)

package/dist/index.js

@@ -46,7 +46,7 @@ const password = process.env.OPENCODE_SERVER_PASSWORD;
 const client = new OpenCodeClient({ baseUrl, username, password });
 const server = new McpServer({
     name: "opencode-mcp",
-    version: "1.0.0",
+    version: "1.0.2",
     description: "Full-featured MCP server wrapping the OpenCode AI headless HTTP server. " +
         "Provides 60+ tools, resources, and prompts to manage sessions, send " +
         "prompts, search files, configure providers, control the TUI, monitor " +
@@ -77,7 +77,7 @@ registerPrompts(server);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error(`opencode-mcp v1.0.0 started (connecting to OpenCode at ${baseUrl})`);
+    console.error(`opencode-mcp v1.0.2 started (connecting to OpenCode at ${baseUrl})`);
 }
 main().catch((err) => {
     console.error("Fatal error starting opencode-mcp:", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server that wraps the OpenCode AI headless server API — 70 tools, 10 resources, 5 prompts for any MCP client",
   "type": "module",
   "main": "dist/index.js",