architectgbt-mcp 0.2.2 → 0.2.4

package/README.md

@@ -1,205 +1,245 @@
 # ArchitectGBT MCP Server
 
-AI model recommendation engine for Cursor, Claude Desktop, and Windsurf.
+**Model Context Protocol (MCP) server for AI model recommendations and code templates.**
 
-Get instant AI model recommendations without leaving your IDE.
+Get instant AI model recommendations for your projects directly in Cursor IDE or Claude Desktop. Compare **50+ models** from OpenAI, Anthropic, Google, Meta, and Mistral with pricing, capabilities, and production-ready code templates.
+
+[![npm version](https://img.shields.io/npm/v/architectgbt-mcp.svg)](https://www.npmjs.com/package/architectgbt-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## Features
 
-- 🎯 **Smart Recommendations** - Get the best AI model for your use case
-- 📝 **Code Templates** - Production-ready integration code
-- 📊 **Model Database** - Compare 50+ AI models with pricing
+### 🎯 AI Model Recommendations
+- **Personalized suggestions** based on your project description
+- **Budget optimization** (low/medium/high/unlimited)
+- **Priority matching** (cost/speed/quality/balanced)
+- **Smart analysis** with reasoning, pros/cons, and alternatives
+- **Cost estimates** with realistic token usage calculations
+
+### 📊 Model Database
+- **50+ AI models** across all major providers
+- **Real-time pricing** per 1M tokens (input/output)
+- **Detailed specs** (context windows, capabilities, speed rankings)
+- **Provider filtering** (OpenAI, Anthropic, Google, Meta, Mistral)
+
+### 💻 Code Templates
+- **Production-ready integrations** for Anthropic, OpenAI, and Google
+- **TypeScript and Python** support
+- **Complete examples** with installation, env setup, and usage
+- **Best practices** including error handling and streaming
 
 ## Installation
 
-### For Cursor
-
-Add to your `~/.cursor/mcp.json` (or `C:\Users\YourName\.cursor\mcp.json` on Windows):
+### Cursor IDE
 
+1. Create `.cursor/mcp.json` in your project:
 ```json
 {
   "mcpServers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["-y", "architectgbt-mcp"]
+      "args": ["-y", "architectgbt-mcp@latest"]
     }
   }
 }
 ```
 
-**Important:** Restart Cursor completely after adding the configuration.
+2. Restart Cursor
+
+3. Ask Claude:
+   - "Recommend an AI model for a customer support chatbot"
+   - "Show me all available AI models"
+   - "Give me Claude Sonnet code in TypeScript"
+
+### Claude Desktop
 
-### For Claude Desktop
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-Add to your Claude Desktop config (`%APPDATA%\Claude\claude_desktop_config.json` on Windows):
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
   "mcpServers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["architectgbt-mcp"]
+      "args": ["-y", "architectgbt-mcp@latest"]
     }
   }
 }
 ```
 
-### For Windsurf
+### VS Code (with Continue or other MCP extensions)
 
-Add to your MCP configuration:
+Install an MCP-compatible extension, then add to settings:
 
 ```json
 {
-  "mcpServers": {
+  "mcp.servers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["architectgbt-mcp"]
+      "args": ["-y", "architectgbt-mcp@latest"]
     }
   }
 }
 ```
 
-## Available Tools
+### Zed Editor
 
-### `list_models`
+Add to `~/.config/zed/settings.json`:
+
+```json
+{
+  "context_servers": {
+    "architectgbt": {
+      "command": "npx",
+      "args": ["-y", "architectgbt-mcp@latest"]
+    }
+  }
+}
+```
 
-List available AI models with pricing information.
+### Any MCP-Compatible Client
 
-**Example prompts:**
-- "List all Anthropic models"
-- "Show me all models"
-- "What OpenAI models are available?"
+This server follows the [Model Context Protocol](https://modelcontextprotocol.io) standard and works with any MCP-compatible client. Run it via stdio:
 
-**Example output:**
-```
-## 📊 Available AI Models
-
-| Model | Provider | Input $/1M | Output $/1M |
-|-------|----------|------------|-------------|
-| Claude Haiku 4.5 | Anthropic | $0.80 | $4.00 |
-| Claude Opus 4.5 | Anthropic | $15.00 | $75.00 |
-| Claude Sonnet 4.5 | Anthropic | $3.00 | $15.00 |
-| GPT-4o | OpenAI | $2.50 | $10.00 |
-| GPT-4o mini | OpenAI | $0.15 | $0.60 |
-...
-
-*Showing 10 models. Use `get_ai_recommendation` for personalized suggestions.*
+```bash
+npx architectgbt-mcp@latest
 ```
 
-### `get_code_template`
+### With API Key (Unlimited Access)
 
-Get production-ready integration code for any AI model.
+Add your API key to any config above:
 
-**Supported providers:** Anthropic (Claude), OpenAI (GPT), Google (Gemini)  
-**Languages:** TypeScript, Python
+```json
+{
+  "mcpServers": {
+    "architectgbt": {
+      "command": "npx",
+      "args": ["-y", "architectgbt-mcp@latest"],
+      "env": {
+        "ARCHITECTGBT_API_KEY": "agbt_your_key_here"
+      }
+    }
+  }
+}
+```
 
-**Example prompts:**
-- "Give me a TypeScript template for Claude"
-- "Python code for OpenAI GPT-4"
-- "Gemini integration in TypeScript"
+## Pricing
 
-**Example output:**
-```typescript
-// ✅ Installation
-npm install @anthropic-ai/sdk
+| Tier | Recommendations | Cost | API Key |
+|------|----------------|------|---------|
+| **Free** | 3/day | $0 | Not needed |
+| **Pro** | Unlimited | $15/month | Required |
 
-// 🔑 Environment Variables
-ANTHROPIC_API_KEY=your_api_key_here
+[Get your API key →](https://architectgbt.com/dashboard/settings)
 
-// 📦 Code
-import Anthropic from '@anthropic-ai/sdk';
+## Tools
 
-const client = new Anthropic({
-  apiKey: process.env.ANTHROPIC_API_KEY,
-});
+### `list_models`
+Lists all 50+ available AI models with pricing.
 
-const message = await client.messages.create({
-  model: 'claude-3-5-sonnet-20241022',
-  max_tokens: 1024,
-  messages: [
-    { role: 'user', content: 'Hello, Claude!' }
-  ],
-});
+```
+User: "Show me all AI models"
 
-console.log(message.content);
+Response:
+Available AI Models (50 total)
+======================================================================
 
-// 💡 Usage Tips
-// - Use streaming for real-time responses
-// - Add system prompts for better control
-// - Handle rate limits with retries
+Anthropic:
+  • Claude Haiku 4.5      $  0.80 / $  4.00 (in/out per 1M tokens)
+  • Claude Sonnet 4.5     $  3.00 / $ 15.00 (in/out per 1M tokens)
+  ...
 ```
 
+**Parameters:**
+- `provider` (optional): Filter by "OpenAI" | "Anthropic" | "Google" | "Meta" | "Mistral"
+- `limit` (optional): Number of models (default: 50)
+
 ### `get_ai_recommendation`
+Get personalized AI model recommendations.
+
+```
+User: "I need an AI for a chatbot handling 10k requests/day"
+
+Response:
+🎯 AI Model Recommendation — Analysis Complete!
 
-Get personalized AI model recommendations based on your project description.
+✨ TOP MATCH (94% match)
 
-**Note:** Requires authentication. For full recommendations with cost analysis and reasoning, visit [architectgbt.com](https://architectgbt.com) and sign up for a free account.
+Claude Haiku 4.5
+Provider: Anthropic
+Estimated Cost: $0.0240
+Context Window: 200,000 tokens
 
-**Example prompts:**
-- "What AI model should I use for a customer support chatbot?"
-- "Recommend a model for code generation on a budget"
-- "Best model for document analysis with 100K context?"
+💡 Why this model?
+Perfect for customer support with fast responses, strong reasoning...
 
-**Example response:**
+✅ Pros:
+  • Extremely fast (sub-second)
+  • Cost-effective at scale
+  ...
 ```
-❌ Authentication Required
 
-The ArchitectGBT API requires authentication. To get AI model recommendations:
+**Parameters:**
+- `prompt` (required): Your project description
+- `budget` (optional): "low" | "medium" | "high" | "unlimited"
+- `priority` (optional): "cost" | "speed" | "quality" | "balanced"
 
-1. Visit https://architectgbt.com
-2. Sign up for a free account (free tier available!)
-3. Use the website directly for personalized recommendations
+- `language` (required): "typescript" | "python"
 
-Alternatively, you can:
-- Use `list_models` to browse available models
-- Use `get_code_template` to get integration code for any model
+## Environment Variables
 
-For your query: "customer support chatbot"
-I recommend visiting the website for a personalized analysis with cost estimates and reasoning.
-```
+- `ARCHITECTGBT_API_KEY` - Your API key for unlimited access (optional)
+- `ARCHITECTGBT_API_URL` - Custom API URL (default: https://architectgbt.com)
+
+## Troubleshooting
+
+### "Daily Limit Reached"
+You've used 3 free recommendations. Options:
+1. Wait for daily reset (midnight UTC)
+2. [Get API key](https://architectgbt.com/dashboard/settings) for unlimited access
+
+### "API Key Invalid"
+1. Check key starts with `agbt_`
+2. Regenerate from [Settings](https://architectgbt.com/dashboard/settings)
+3. Ensure it's in the `env` section of your config
+
+### Models Not Showing
+1. Check internet connection
+2. Verify: https://architectgbt.com/api/models
+3. Try: `npx architectgbt-mcp@latest` manually
+
+### MCP Not Loading
+1. Node.js >= 18.0.0 required
+2. Check config JSON syntax
+3. Restart Cursor after changes
 
 ## Development
 
 ```bash
-# Install dependencies
+git clone https://github.com/yourusername/architectgbt-mcp.git
+cd architectgbt-mcp
 npm install
-
-# Run in development mode
-npm run dev
-
-# Build for production
 npm run build
-
-# Start production server
-npm start
+npm run dev
 ```
 
-## Local Testing
-
-To test locally before publishing, update your MCP config to point to the built file:
+## Links
 
-```json
-{
-  "mcpServers": {
-    "architectgbt": {
-      "command": "node",
-      "args": ["C:/Users/pravi/workspacenew/architectgbt-mcp/dist/index.js"]
-    }
-  }
-}
-```
+- **Website**: [architectgbt.com](https://architectgbt.com)
+- **Docs**: [architectgbt.com/docs/mcp-integration](https://architectgbt.com/docs/mcp-integration)
+- **API Keys**: [architectgbt.com/dashboard/settings](https://architectgbt.com/dashboard/settings)
+- **NPM**: [npmjs.com/package/architectgbt-mcp](https://www.npmjs.com/package/architectgbt-mcp)
 
-## Environment Variables
+## Support
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `ARCHITECTGBT_API_URL` | API base URL | `https://architectgbt.com` |
+- **Email**: hello@architectgbt.com
+- **Issues**: [GitHub](https://github.com/yourusername/architectgbt-mcp/issues)
 
 ## License
 
-MIT
+MIT © ArchitectGBT
 
-## Links
+---
 
-- [ArchitectGBT Website](https://architectgbt.com)
-- [MCP Documentation](https://modelcontextprotocol.io)
+**Built with ❤️ for developers who ship fast**

package/dist/tools/list-models.js

@@ -13,7 +13,7 @@ export const listModelsTool = {
             },
             limit: {
                 type: "number",
-                description: "Maximum number of models to return (default: 10)",
+                description: "Maximum number of models to return (default: 50)",
             },
         },
         required: [],
@@ -23,7 +23,7 @@ const InputSchema = z.object({
     provider: z
         .enum(["OpenAI", "Anthropic", "Google", "Meta", "Mistral", "all"])
         .optional(),
-    limit: z.number().default(10),
+    limit: z.number().default(50),
 });
 export async function handleListModels(args) {
     const input = InputSchema.parse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "architectgbt-mcp",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Model Context Protocol server for ArchitectGBT - AI architecture recommendations",
   "type": "module",
   "bin": {

package/src/tools/list-models.ts

@@ -16,7 +16,7 @@ export const listModelsTool = {
       },
       limit: {
         type: "number",
-        description: "Maximum number of models to return (default: 10)",
+        description: "Maximum number of models to return (default: 50)",
       },
     },
     required: [],
@@ -27,7 +27,7 @@ const InputSchema = z.object({
   provider: z
     .enum(["OpenAI", "Anthropic", "Google", "Meta", "Mistral", "all"])
     .optional(),
-  limit: z.number().default(10),
+  limit: z.number().default(50),
 });
 
 export async function handleListModels(args: unknown) {