@msegoviadev/api-mind-mcp 0.1.0 → 0.2.3-next.1.0

package/README.md

@@ -2,96 +2,56 @@
 
 MCP server for API discovery from `.mind` spec files. Works with Claude Code, Claude Desktop, and any MCP-compatible AI assistant.
 
-## Why
+## Quick Start
 
-LLMs interacting with HTTP APIs need to discover endpoints, understand contracts, and make requests. api-mind provides 3 tools for discovery and context:
-
-- **list_apis** - Discover available APIs
-- **list_endpoints** - Find endpoints across APIs
-- **get_endpoint_schema** - Get base URL, auth requirements, and schema
-
-The LLM then constructs and executes curl commands with full transparency.
-
-## Installation
-
-### Option 1: Command-line argument (Recommended)
+Try it now with example specs:
 
 ```bash
+# Use built-in examples (after installation)
 claude mcp add --transport stdio api-mind \
-  -- npx -y @msegoviadev/api-mind-mcp /Users/YOUR/absolute/path/to/specs
-```
-
-**Important:** Use ABSOLUTE paths. Relative paths are not supported.
-
-### Option 2: Environment variable
+  -- npx -y @msegoviadev/api-mind-mcp $(pwd)/specs
 
-```bash
+# Or with your own specs
 claude mcp add --transport stdio api-mind \
-  --env SPECS_DIR=/Users/YOUR/absolute/path/to/specs \
-  -- npx -y @msegoviadev/api-mind-mcp
+  -- npx -y @msegoviadev/api-mind-mcp /absolute/path/to/specs
 ```
 
-### Option 3: Project configuration (Best for Teams)
-
-Create `.mcp.json` in your project root:
-
-```json
-{
-  "mcpServers": {
-    "api-mind": {
-      "command": "npx",
-      "args": ["-y", "@msegoviadev/api-mind-mcp"],
-      "env": {
-        "SPECS_DIR": "/Users/yourname/projects/yourproject/specs"
-      }
-    }
-  }
-}
+In Claude Code:
+```
+What APIs are available?
+Show me the endpoints for posts
+Get the schema for GET /posts
 ```
 
-**Note:** Each team member needs their own `.mcp.json` with their absolute path. Add `.mcp.json` to `.gitignore`.
+---
 
-### Setup Script for Teams
+## Installation
 
-Create `setup-mcp.sh` in your project root:
+### Prerequisites
 
-```bash
-#!/bin/bash
-PROJECT_ROOT="$(cd "$(dirname "$0")" && pwd)"
-claude mcp add --transport stdio --scope project api-mind \
-  --env SPECS_DIR="${PROJECT_ROOT}/specs" \
-  -- npx -y @msegoviadev/api-mind-mcp
-```
+Install [spec-mind](https://github.com/msegoviadev/spec-mind) to generate `.mind` files from your OpenAPI specs:
 
-Team members run once:
 ```bash
-chmod +x setup-mcp.sh
-./setup-mcp.sh
+npm install -g @msegoviadev/spec-mind
 ```
 
-## Local Development
-
-For testing locally:
+### Install api-mind-mcp
 
 ```bash
-cd /path/to/api-mind-claude
-npm install
-npm run build
-
-# Test with command-line argument
-node dist/index.js /absolute/path/to/specs
+claude mcp add --transport stdio api-mind \
+  -- npx -y @msegoviadev/api-mind-mcp /absolute/path/to/specs
+```
 
-# Test with environment variable
-SPECS_DIR=/absolute/path/to/specs node dist/index.js
+**Important:** 
+- Always use **absolute paths** (MCP servers don't have project context)
+- Use `$(pwd)/specs` to reference your current directory
+- Or use full paths like `/Users/you/projects/your-project/specs`
 
-# Add to Claude Code for testing
-claude mcp add --transport stdio api-mind-dev \
-  -- node /path/to/api-mind-claude/dist/index.js /absolute/path/to/specs
-```
+---
 
-## Setup
+## Usage
 
-### 1. Add OpenAPI specs
+### 1. Add your API specs
 
 ```bash
 mkdir specs
@@ -101,25 +61,50 @@ mkdir specs
 ### 2. Generate .mind files
 
 ```bash
-npm install -g @msegoviadev/spec-mind
-spec-mind sync --no-notation ./specs/
+cd specs
+spec-mind sync --no-notation ./
 ```
 
-### 3. Commit both files
+### 3. Configure with your specs
+
+**From your project directory:**
 
 ```bash
-git add specs/*.yaml specs/*.mind
-git commit -m "Add API specs"
+# Use specs in current directory
+claude mcp add --transport stdio api-mind \
+  -- npx -y @msegoviadev/api-mind-mcp $(pwd)/specs
+
+# Or specify full path
+claude mcp add --transport stdio api-mind \
+  -- npx -y @msegoviadev/api-mind-mcp /Users/you/projects/your-project/specs
 ```
 
-### 4. Configure api-mind
+**Important:** MCP servers require absolute paths. Use `$(pwd)` or full paths, never relative paths like `./specs`.
 
-Use one of the installation methods above to configure the specs directory.
+### 4. Use in Claude Code
+
+```
+User: "What APIs are available?"
+Claude: *uses list_apis tool*
+"Found 2 APIs: ecommerce, payments"
+
+User: "Show me payment endpoints"
+Claude: *uses list_endpoints tool*
+"POST /payments [auth: oauth2]
+ GET /payments/{id}"
+
+User: "Get schema for POST /payments"
+Claude: *uses get_endpoint_schema tool*
+"POST /payments
+Auth: oauth2 payments:write
+Body: CreatePaymentRequest {...}"
+```
+
+---
 
 ## Tools
 
 ### list_apis
-
 Lists all APIs loaded from the specs folder.
 
 ```
@@ -130,20 +115,17 @@ Output: JSON with API names, titles, base URLs, and environments
 Call first to discover what APIs are available.
 
 ### list_endpoints
-
 Lists endpoints across all APIs.
 
 ```
 Input:
   filter (optional): Substring match on method, path, or section
-
 Output: JSON with environments and endpoint list
 ```
 
 Call to find specific endpoints.
 
 ### get_endpoint_schema
-
 Returns full context for an endpoint.
 
 ```
@@ -151,23 +133,12 @@ Input:
   api: API name
   method: HTTP method
   path: Endpoint path
-
 Output: Text block with base URL, environments, auth, and schema
 ```
 
 Call before constructing curl to understand the endpoint.
 
-## Workflow
-
-```
-list_apis → list_endpoints → get_endpoint_schema → [LLM constructs curl] → bash
-```
-
-1. `list_apis` - Discover available APIs
-2. `list_endpoints` - Find relevant endpoints
-3. `get_endpoint_schema` - Get context (URL, auth, schema)
-4. LLM constructs curl command with proper URL and headers
-5. LLM executes via `bash` tool
+---
 
 ## Auth Patterns
 
@@ -181,60 +152,100 @@ When `get_endpoint_schema` shows auth requirements, construct headers:
 | `api_key <header>` | `-H '<header>: <KEY>'` |
 | `basic` | `-H 'Authorization: Basic <base64>'` |
 
+---
+
 ## Why Absolute Paths?
 
 MCP servers run as standalone processes without project context. The working directory may be `/` or a system directory. Unlike plugins that receive project context, MCP servers must receive explicit configuration.
 
 Always use absolute paths when configuring MCP servers.
 
-## Example Usage
+---
 
-Once configured, use the tools directly in Claude Code:
+## Workflow
 
 ```
-User: "What APIs are available?"
-Claude: *uses list_apis tool*
-"I found 2 APIs loaded:
-1. ecommerce - E-commerce API
-2. payments - Payments API"
+list_apis → list_endpoints → get_endpoint_schema → [LLM constructs curl] → bash
+```
 
-User: "Show me the endpoints for creating a payment"
-Claude: *uses list_endpoints tool with filter="payment"*
-"Here are payment endpoints:
-POST /payments [auth: oauth2 payments:write]
-..."
+1. `list_apis` - Discover available APIs
+2. `list_endpoints` - Find relevant endpoints
+3. `get_endpoint_schema` - Get context (URL, auth, schema)
+4. LLM constructs curl command with proper URL and headers
+5. LLM executes via `bash` tool
 
-User: "Get the schema for POST /payments"
-Claude: *uses get_endpoint_schema tool*
-"POST /payments
-Auth: oauth2 payments:write
-Body: CreatePaymentRequest {...}
-..."
-```
+---
 
-## NOTATION Legend
+## Advanced Configuration
 
-The schema uses a compact notation:
+<details>
+<summary>For teams and advanced users</summary>
 
+### Environment Variable
+
+```bash
+claude mcp add --transport stdio api-mind \
+  --env SPECS_DIR=/absolute/path/to/specs \
+  -- npx -y @msegoviadev/api-mind-mcp
 ```
-? optional | [ro] readOnly | [w] writeOnly | =val default
-^ header | ~ cookie | | enum | {*:T} map | ~~name~~ deprecated
+
+### Project Configuration (.mcp.json)
+
+Create `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "api-mind": {
+      "command": "npx",
+      "args": ["-y", "@msegoviadev/api-mind-mcp"],
+      "env": {
+        "SPECS_DIR": "/absolute/path/to/specs"
+      }
+    }
+  }
+}
 ```
 
-## Development
+**Note:** Each team member needs their own `.mcp.json` with their absolute path. Add `.mcp.json` to `.gitignore`.
+
+### Setup Script (Optional)
 
-### Build
+For automated team setup, copy `setup-mcp.sh.example` to your project:
 
 ```bash
-npm run build
+curl -O https://raw.githubusercontent.com/msegoviadev/api-mind-mcp/main/setup-mcp.sh.example
+mv setup-mcp.sh.example setup-mcp.sh
+chmod +x setup-mcp.sh
+./setup-mcp.sh
 ```
 
-### Test Locally
+The script will:
+- Auto-detect project root
+- Create `specs/` directory
+- Configure Claude Code with absolute paths
+- Check for `.mind` files
+
+</details>
+
+---
+
+## Development (Contributors)
+
+For developing api-mind-mcp itself:
 
 ```bash
-node dist/index.js /absolute/path/to/specs
+git clone https://github.com/msegoviadev/api-mind-mcp
+cd api-mind-mcp
+npm install
+npm run build
+
+# Test locally
+node dist/index.js /path/to/specs
 ```
 
+---
+
 ## Related
 
 - [spec-mind](https://github.com/msegoviadev/spec-mind) - Generate `.mind` files from OpenAPI specs

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,QAAA,MAAQ,MAAM,KAAyD,CAAC;AACxE,QAAA,MAAQ,oBAAoB,KAAyD,CAAC;AACtF,QAAA,MACE,qBAAqB,OACrB,sBAAsB,KACyB,CAAC;AAClD,QAAA,MAAQ,SAAS,KAAgC,CAAC;AAClD,QAAA,MAAQ,gBAAgB,KAAsC,CAAC;AAC/D,QAAA,MAAoB,kBAAkB,OAAW,eAAe,KAAoC,CAAC;AACrG,QAAA,MAAoB,uBAAuB,OAAW,oBAAoB,KAAyC,CAAC;AACpH,QAAA,MAAoB,2BAA2B,OAAW,wBAAwB,KAA8C,CAAC;AACjI,QAAA,MAAQ,OAAO,OAAE,UAAU,KAAoB,CAAC;AAMhD,iBAAS,WAAW,WAkEnB;AAED,QAAA,MAAM,SAAS,QAAgB,CAAC;AAGhC,QAAA,MAAM,MAAM,KAUX,CAAC;AAGF,QAAA,IAAI,UAAU,SAAQ,CAAC;AACvB,QAAA,IAAI,UAAU,KAAO,CAAC;AAiFtB,iBAAe,IAAI,kBAIlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,QAAA,MAAQ,MAAM,KAAyD,CAAC;AACxE,QAAA,MAAQ,oBAAoB,KAAyD,CAAC;AACtF,QAAA,MACE,qBAAqB,OACrB,sBAAsB,KACyB,CAAC;AAClD,QAAA,MAAQ,SAAS,KAAgC,CAAC;AAClD,QAAA,MAAQ,gBAAgB,KAAsC,CAAC;AAC/D,QAAA,MAAoB,kBAAkB,OAAW,eAAe,KAAoC,CAAC;AACrG,QAAA,MAAoB,uBAAuB,OAAW,oBAAoB,KAAyC,CAAC;AACpH,QAAA,MAAoB,2BAA2B,OAAW,wBAAwB,KAA8C,CAAC;AACjI,QAAA,MAAQ,OAAO,OAAE,UAAU,KAAoB,CAAC;AAMhD,iBAAS,WAAW,WA0EnB;AAED,QAAA,MAAM,SAAS,QAAgB,CAAC;AAGhC,QAAA,MAAM,MAAM,KAUX,CAAC;AAGF,QAAA,IAAI,UAAU,SAAQ,CAAC;AACvB,QAAA,IAAI,UAAU,KAAO,CAAC;AAiFtB,iBAAe,IAAI,kBAIlB"}

package/dist/index.js

@@ -45,24 +45,32 @@ Use:
         console.error(`[api-mind] Specs directory: ${process.env.SPECS_DIR}`);
         return process.env.SPECS_DIR;
     }
-    // Priority 3: No configuration - help user
+    // Priority 3: No configuration - show setup options
     console.error(`
 [api-mind] ERROR: No specs directory configured.
 
+Quick examples:
+
+  # Use your own specs directory
+  claude mcp add api-mind -- npx -y @msegoviadev/api-mind-mcp $(pwd)/specs
+
+  # Or specify full path
+  claude mcp add api-mind -- npx -y @msegoviadev/api-mind-mcp /Users/you/projects/your-project/specs
+
 Setup options:
 
 1. Command-line argument:
-   claude mcp add api-mind -- node dist/index.js /ABSOLUTE/PATH/TO/SPECS
+   claude mcp add api-mind -- npx -y @msegoviadev/api-mind-mcp /ABSOLUTE/PATH/TO/SPECS
 
 2. Environment variable:
-   claude mcp add api-mind --env SPECS_DIR=/ABSOLUTE/PATH/TO/SPECS -- node dist/index.js
+   claude mcp add api-mind --env SPECS_DIR=/ABSOLUTE/PATH/TO/SPECS -- npx -y @msegoviadev/api-mind-mcp
 
 3. Project .mcp.json:
    {
      "mcpServers": {
        "api-mind": {
-         "command": "node",
-         "args": ["/path/to/api-mind-claude/dist/index.js"],
+         "command": "npx",
+         "args": ["-y", "@msegoviadev/api-mind-mcp"],
          "env": { "SPECS_DIR": "/ABSOLUTE/PATH/TO/SPECS" }
        }
      }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@msegoviadev/api-mind-mcp",
-  "version": "0.1.0",
+  "version": "0.2.3-next.1.0",
   "description": "MCP server for API discovery from .mind spec files",
   "main": "./dist/index.js",
   "bin": {
@@ -16,6 +16,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "semver": "^7.7.4",
     "typescript": "^5.0.0"
   },
   "keywords": [
@@ -46,9 +47,10 @@
     "setup-mcp.sh.example"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}