@gopersonal/advisor 1.0.3 → 1.0.4

package/README.md

@@ -7,47 +7,64 @@ An MCP server that gives AI agents access to a separate AI advisor via [OpenCode
 - **ask_advisor** — Get help when stuck after multiple failed attempts
 - **get_second_opinion** — Sanity-check a decision between approaches
 
-## Add to Claude Code
-
-### Option A: OpenAI endpoint
+## Quick Start
 
 ```bash
 claude mcp add advisor \
   -e ADVISOR_PROVIDER=openai \
   -e ADVISOR_MODEL=gpt-4o \
   -e ADVISOR_API_KEY=sk-your-key \
+  -e ADVISOR_BASE_URL=https://api.openai.com/v1 \
   -- npx -y @gopersonal/advisor
 ```
 
-With a custom OpenAI-compatible endpoint:
+## Setup
+
+### Option A: OpenAI-compatible endpoint
+
+Works with OpenAI, MiniMax, Together, Groq, and any `/v1/chat/completions` endpoint.
 
 ```bash
 claude mcp add advisor \
   -e ADVISOR_PROVIDER=openai \
   -e ADVISOR_MODEL=gpt-4o \
   -e ADVISOR_API_KEY=sk-your-key \
-  -e ADVISOR_BASE_URL=https://your-openai-proxy.example.com/v1 \
+  -e ADVISOR_BASE_URL=https://api.openai.com/v1 \
+  -- npx -y @gopersonal/advisor
+```
+
+Example with MiniMax (tested):
+
+```bash
+claude mcp add advisor \
+  -e ADVISOR_PROVIDER=openai \
+  -e ADVISOR_MODEL=MiniMax-M2.5 \
+  -e ADVISOR_API_KEY=sk-your-minimax-key \
+  -e ADVISOR_BASE_URL=https://api.minimax.io/v1 \
   -- npx -y @gopersonal/advisor
 ```
 
-### Option B: Anthropic endpoint
+### Option B: Anthropic-compatible endpoint
+
+Works with Anthropic and any `/v1/messages` endpoint.
 
 ```bash
 claude mcp add advisor \
   -e ADVISOR_PROVIDER=anthropic \
   -e ADVISOR_MODEL=claude-sonnet-4-5 \
   -e ADVISOR_API_KEY=sk-ant-your-key \
+  -e ADVISOR_BASE_URL=https://api.anthropic.com \
   -- npx -y @gopersonal/advisor
 ```
 
-With a custom Anthropic-compatible endpoint:
+Example with a proxy (tested):
 
 ```bash
 claude mcp add advisor \
   -e ADVISOR_PROVIDER=anthropic \
-  -e ADVISOR_MODEL=claude-sonnet-4-5 \
+  -e ADVISOR_MODEL=gpt-5.2-codex \
   -e ADVISOR_API_KEY=none \
-  -e ADVISOR_BASE_URL=https://your-anthropic-proxy.example.com \
+  -e ADVISOR_BASE_URL=https://azure-openai-anthropic-proxy.go-shops.workers.dev \
   -- npx -y @gopersonal/advisor
 ```
 
@@ -57,30 +74,54 @@ claude mcp add advisor \
 claude mcp add advisor -- npx -y @gopersonal/advisor
 ```
 
+### With project context and instructions
+
+Give the advisor context about your project so it can provide more relevant advice:
+
+```bash
+claude mcp add advisor \
+  -e ADVISOR_PROVIDER=anthropic \
+  -e ADVISOR_MODEL=gpt-5.2-codex \
+  -e ADVISOR_API_KEY=none \
+  -e ADVISOR_BASE_URL=https://azure-openai-anthropic-proxy.go-shops.workers.dev \
+  -e ADVISOR_DIRECTORY=/Users/me/myproject \
+  -e ADVISOR_INSTRUCTIONS=/Users/me/myproject/AGENTS.md \
+  -- npx -y @gopersonal/advisor
+```
+
 ## Environment Variables
 
-| Variable | Description | Example |
-|---|---|---|
-| `ADVISOR_PROVIDER` | `openai` or `anthropic` | `openai` |
-| `ADVISOR_MODEL` | Model name | `gpt-4o`, `claude-sonnet-4-5` |
-| `ADVISOR_API_KEY` | API key for the provider | `sk-...` |
-| `ADVISOR_BASE_URL` | Custom base URL (optional) | `https://proxy.example.com` |
-| `ADVISOR_DIRECTORY` | Project directory for opencode context (optional) | `/Users/me/myproject` |
-| `ADVISOR_INSTRUCTIONS` | Path to instructions/AGENTS.md file (optional) | `/Users/me/myproject/AGENTS.md` |
+| Variable | Required | Description | Example |
+|---|---|---|---|
+| `ADVISOR_PROVIDER` | Yes | `openai` or `anthropic` | `openai` |
+| `ADVISOR_MODEL` | Yes | Model name | `gpt-4o`, `claude-sonnet-4-5` |
+| `ADVISOR_API_KEY` | Yes | API key for the provider | `sk-...` |
+| `ADVISOR_BASE_URL` | Yes | API base URL | `https://api.openai.com/v1` |
+| `ADVISOR_DIRECTORY` | No | Project directory for opencode context | `/Users/me/myproject` |
+| `ADVISOR_INSTRUCTIONS` | No | Path to instructions file (AGENTS.md, etc.) | `/Users/me/myproject/AGENTS.md` |
 
-`ADVISOR_DIRECTORY` gives the advisor context about your project (file structure, code, etc.).
-`ADVISOR_INSTRUCTIONS` loads a custom instructions file (like AGENTS.md) so the advisor knows your project conventions.
+- `ADVISOR_PROVIDER` determines the API format: `openai` uses `/v1/chat/completions`, `anthropic` uses `/v1/messages`
+- `ADVISOR_DIRECTORY` gives the advisor access to your project files and structure
+- `ADVISOR_INSTRUCTIONS` loads a custom instructions file so the advisor knows your project conventions
 
 If no env vars are set, the advisor connects to a running opencode instance or starts one using your default opencode config.
 
 ## How it works
 
 1. Agent calls `ask_advisor` or `get_second_opinion` via MCP
-2. The server creates a temporary OpenCode session
+2. The server creates a temporary OpenCode session (scoped to `ADVISOR_DIRECTORY` if set)
 3. Sends the prompt asynchronously, polls for the response
 4. Auto-answers any interactive questions from the OpenCode agent
 5. Returns the advisor's response and cleans up the session
 
+## Tested configurations
+
+| Provider | Model | Base URL | Status |
+|---|---|---|---|
+| `anthropic` | `gpt-5.2-codex` | `azure-openai-anthropic-proxy.go-shops.workers.dev` | Working |
+| `openai` | `MiniMax-M2.5` | `api.minimax.io/v1` | Working |
+| `anthropic` | `gpt-5.2-codex` | proxy + `ADVISOR_DIRECTORY` + `ADVISOR_INSTRUCTIONS` | Working |
+
 ## Requirements
 
 - [OpenCode](https://opencode.ai) installed (`brew install sst/tap/opencode` or `npm i -g opencode`)
@@ -108,7 +149,7 @@ claude mcp add advisor -- node /path/to/advisor/build/index.js
 npm login
 ```
 
-2. Update the version in `package.json`:
+2. Update the version:
 
 ```bash
 npm version patch   # 1.0.0 -> 1.0.1 (bug fixes)

package/build/index.js

@@ -3,6 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { createOpencode, createOpencodeClient } from "@opencode-ai/sdk/v2";
+import { existsSync } from "fs";
 // --- Environment-based configuration ---
 //
 // Pass these via the "env" field in the MCP config JSON.
@@ -68,7 +69,8 @@ function buildOpencodeConfig() {
     const apiKey = process.env.ADVISOR_API_KEY;
     const baseURL = process.env.ADVISOR_BASE_URL;
     const npm = process.env.ADVISOR_NPM || resolved?.npm;
-    const instructions = process.env.ADVISOR_INSTRUCTIONS;
+    const instructionsPath = process.env.ADVISOR_INSTRUCTIONS;
+    const instructions = instructionsPath && existsSync(instructionsPath) ? instructionsPath : undefined;
     const config = {
         // Disable title generation (it uses small_model which may not work with custom providers)
         small_model: resolved?.fullModel || undefined,
@@ -77,6 +79,8 @@ function buildOpencodeConfig() {
     };
     if (instructions)
         console.error(`[advisor] Instructions: ${instructions}`);
+    if (instructionsPath && !instructions)
+        console.error(`[advisor] Instructions file not found: ${instructionsPath}, skipping`);
     if (resolved) {
         config.model = resolved.fullModel;
         console.error(`[advisor] Provider: ${resolved.provider}, Model: ${resolved.model}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gopersonal/advisor",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "type": "module",
   "main": "./build/index.js",
   "bin": {