@adorbistech/mcp-server 1.0.1 → 1.0.2

package/README.md

@@ -9,6 +9,7 @@ Use Adorbis AI from Claude Code, Cursor, Cline, and any MCP-compatible tool.
 
 [![npm version](https://img.shields.io/npm/v/@adorbistech/mcp-server?color=1e9ad6&label=npm)](https://www.npmjs.com/package/@adorbistech/mcp-server)
 [![license](https://img.shields.io/npm/l/@adorbistech/mcp-server?color=d2bbff)](LICENSE)
+[![node](https://img.shields.io/node/v/@adorbistech/mcp-server?color=4be257)](https://nodejs.org)
 
 [Get a free API key](https://ai.adorbistech.com) · [Documentation](https://ai.adorbistech.com/docs) · [Dashboard](https://ai.adorbistech.com/dashboard)
 
@@ -16,26 +17,31 @@ Use Adorbis AI from Claude Code, Cursor, Cline, and any MCP-compatible tool.
 
 ---
 
-## Quick Install
+## Install
 
-### Claude Code
+### Option 1 — Clone and run locally (recommended, works on all platforms)
 
 ```bash
-claude mcp add adorbis -- npx -y @adorbistech/mcp-server
+git clone https://github.com/adorbistech/adorbis-mcp
+cd adorbis-mcp
+npm install
+npm run build
 ```
 
-Then set your API key:
-```bash
-claude mcp add adorbis -e ADORBIS_API_KEY=your_key_here -- npx -y @adorbistech/mcp-server
-```
+Then point your tool to `node /path/to/adorbis-mcp/dist/index.js`.
+
+---
+
+### Claude Code
+
+Add to `~/.claude.json`:
 
-Or add to `~/.claude/settings.json`:
 ```json
 {
   "mcpServers": {
     "adorbis": {
-      "command": "npx",
-      "args": ["-y", "@adorbistech/mcp-server"],
+      "command": "node",
+      "args": ["/path/to/adorbis-mcp/dist/index.js"],
       "env": {
         "ADORBIS_API_KEY": "your_key_here"
       }
@@ -44,17 +50,28 @@ Or add to `~/.claude/settings.json`:
 }
 ```
 
+**Windows path example:**
+```json
+"args": ["D:\\Ai-Adorbis\\MCP\\dist\\index.js"]
+```
+
+**Mac/Linux path example:**
+```json
+"args": ["/home/user/adorbis-mcp/dist/index.js"]
+```
+
 ---
 
 ### Cursor
 
-Add to Cursor MCP settings (`~/.cursor/mcp.json`):
+Add to `~/.cursor/mcp.json`:
+
 ```json
 {
   "mcpServers": {
     "adorbis": {
-      "command": "npx",
-      "args": ["-y", "@adorbistech/mcp-server"],
+      "command": "node",
+      "args": ["/path/to/adorbis-mcp/dist/index.js"],
       "env": {
         "ADORBIS_API_KEY": "your_key_here"
       }
@@ -67,16 +84,15 @@ Add to Cursor MCP settings (`~/.cursor/mcp.json`):
 
 ### Cline (VS Code)
 
-Add to `.vscode/settings.json` or Cline MCP settings:
+Add to Cline MCP settings:
+
 ```json
 {
-  "cline.mcpServers": {
-    "adorbis": {
-      "command": "npx",
-      "args": ["-y", "@adorbistech/mcp-server"],
-      "env": {
-        "ADORBIS_API_KEY": "your_key_here"
-      }
+  "adorbis": {
+    "command": "node",
+    "args": ["/path/to/adorbis-mcp/dist/index.js"],
+    "env": {
+      "ADORBIS_API_KEY": "your_key_here"
     }
   }
 }
@@ -84,63 +100,55 @@ Add to `.vscode/settings.json` or Cline MCP settings:
 
 ---
 
-### Auto-configure with CLI
+### Option 2 — npx (Mac/Linux only)
 
-Use `adorbis-init` to configure everything automatically:
 ```bash
-npx adorbis-init --mcps
+# Mac/Linux
+ADORBIS_API_KEY=your_key npx @adorbistech/mcp-server
 ```
 
----
-
-## Available Tools
+> **Note:** `npx` install is not recommended on Windows due to path resolution issues. Use the clone method above.
 
-Once connected, your AI assistant has access to these tools:
+---
 
-### `adorbis_chat`
-General-purpose AI chat. Auto-routes to the best model for your task.
+### Auto-configure with CLI
 
-```
-Ask Adorbis: What is the difference between TCP and UDP?
+```bash
+npx adorbis-init --mcps
 ```
 
-### `adorbis_code`
-Code generation, debugging, review, and explanation. Routes to the best coding model automatically.
+Automatically writes the correct MCP config for every tool you have configured.
 
-```
-Use adorbis_code to write a TypeScript function that debounces API calls
-```
-
-### `adorbis_reason`
-Complex reasoning — math, logic, multi-step analysis. Routes to frontier reasoning models.
+---
 
-```
-Use adorbis_reason to analyze the time complexity of this algorithm
-```
+## Available Tools
 
-### `adorbis_write`
-Long-form writing — documentation, articles, emails, reports.
+Once connected, your AI assistant has access to 7 tools:
 
-```
-Use adorbis_write to create a README for my project
-```
+| Tool | Description |
+|---|---|
+| `adorbis_chat` | General AI chat — auto-routes to best model |
+| `adorbis_code` | Code generation, debugging, review |
+| `adorbis_reason` | Math, logic, multi-step analysis |
+| `adorbis_write` | Documentation, articles, emails |
+| `adorbis_balance` | Check connection and credit status |
+| `adorbis_models` | List all available departments |
+| `adorbis_multi_turn` | Multi-turn conversation with history |
 
-### `adorbis_balance`
-Check your Adorbis AI credit balance and account status.
+### Usage examples
 
 ```
 Check my Adorbis balance
 ```
-
-### `adorbis_models`
-List all available departments and what they're best for.
-
+```
+Use adorbis_code to write a TypeScript debounce function
+```
 ```
 What Adorbis departments are available?
 ```
-
-### `adorbis_multi_turn`
-Multi-turn conversations with full message history.
+```
+Use adorbis_reason to analyze the time complexity of merge sort
+```
 
 ---
 
@@ -176,9 +184,13 @@ Your tool (Claude Code / Cursor / Cline)
     ▼         ▼          ▼
  Gemini   DeepSeek   Claude
  Flash      V3       Sonnet
+              │
+              ▼
+         Best model
+         for your task
 ```
 
-Adorbis monitors model health, latency, and cost in real time. When you send a request, it routes to the best available model for that department — automatically. No manual model switching.
+Adorbis monitors model health, latency, and cost in real time. When you send a request, it routes to the best available model automatically. No manual model switching. No vendor lock-in.
 
 ---
 
@@ -188,7 +200,7 @@ Adorbis monitors model health, latency, and cost in real time. When you send a r
 |---|---|---|
 | `ADORBIS_API_KEY` | Yes | Your Adorbis API key |
 
-Get a free key (1,000 credits/month) at **https://ai.adorbistech.com**
+Get a free key (1,000 credits/month, no credit card) at **https://ai.adorbistech.com**
 
 ---
 
@@ -201,7 +213,7 @@ Get a free key (1,000 credits/month) at **https://ai.adorbistech.com**
 | Pro | $30/mo | 50,000 AC |
 | Business | $100/mo | 200,000 AC |
 
-1 AC = $0.001 of compute. [Upgrade →](https://ai.adorbistech.com/dashboard)
+1 AC = $0.001 of underlying compute. [Upgrade →](https://ai.adorbistech.com/dashboard)
 
 ---
 
@@ -209,7 +221,20 @@ Get a free key (1,000 credits/month) at **https://ai.adorbistech.com**
 
 - **VS Code Extension** — `ext install adorbis.adorbis-ai`
 - **CLI setup wizard** — `npx adorbis-init`
-- **Docs** — [ai.adorbistech.com/docs](https://ai.adorbistech.com/docs)
+- **Full docs** — [ai.adorbistech.com/docs](https://ai.adorbistech.com/docs)
+
+---
+
+## Requirements
+
+- Node.js >= 18
+- An Adorbis API key — [get one free](https://ai.adorbistech.com)
+
+---
+
+## Contributing
+
+Issues and PRs welcome at [github.com/adorbistech/adorbis-mcp](https://github.com/adorbistech/adorbis-mcp)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adorbistech/mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Adorbis AI MCP server — one key, every model, auto-routed. Use Adorbis AI from Claude Code, Cursor, Cline, and any MCP-compatible tool.",
   "main": "dist/index.js",
   "bin": {
@@ -49,5 +49,6 @@
     "dist",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "mcpName": "io.github.adorbistech/adorbis-mcp"
 }