@index9/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Index9
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# @index9/mcp
+
+[![npm version](https://badge.fury.io/js/%40index9%2Fmcp.svg)](https://badge.fury.io/js/%40index9%2Fmcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Give your AI assistant up-to-date model knowledge. 1000+ models with real-time pricing, context windows, and capabilities. Latest data, instant responses, zero cost.
+
+## ❌ Without Index9 MCP
+
+LLMs rely on outdated training data about AI models:
+
+- ❌ "Use GPT-4 for complex reasoning" (missing GPT-5.1, Claude Opus 4.5, and latest models)
+- ❌ "This fits in GPT-3.5's 4K context" (current models have 128K-2M+ context windows)
+- ❌ Generic advice without real pricing or capability comparisons
+- ❌ No awareness of cutting-edge models released this month
+
+## ✅ With Index9 MCP
+
+Your AI assistant has real-time access to the latest models and provides specific, data-driven recommendations:
+
+- ✅ "Use **GPT-5.1** - 400K context, $1.25/million input, latest frontier-grade reasoning with adaptive computation"
+- ✅ "For massive documents, try **Grok 4.1 Fast** with 2M context at $0.2/million input tokens"
+- ✅ "Vision + reasoning needed? Use **Claude Opus 4.5** at $5/million - multimodal with 200K context"
+- ✅ "Budget option: **Arcee Trinity Mini** at $0.04/million for text-only tasks"
+- ✅ Compare the latest models side-by-side with current pricing, test live performance, and get cutting-edge recommendations
+
+> *🤖 This section was written using Index9 MCP data - the AI assistant knew about Arcee Trinity Mini before it was cool!*
+
+## Quick Start
+
+### Cursor
+
+Open Cursor Settings → MCP → Add new global MCP server
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+### VS Code
+
+Open VS Code Settings → MCP Servers → Add Server
+
+```json
+"mcp": {
+  "servers": {
+    "index9": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+### Other MCP Clients
+
+#### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+#### Claude Code
+
+Run in terminal:
+
+```bash
+claude mcp add index9 -- npx -y @index9/mcp
+```
+
+#### Windsurf
+
+Add to Windsurf MCP config file
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+#### Cline
+
+Open Cline → MCP Servers → Edit Configuration
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["-y", "@index9/mcp"]
+    }
+  }
+}
+```
+
+## Configuration
+
+### Testing Models (Optional)
+
+To use the `test_model` tool, add your OpenRouter API key:
+
+```json
+{
+  "mcpServers": {
+    "index9": {
+      "command": "npx",
+      "args": ["@index9/mcp"],
+      "env": {
+        "OPEN_ROUTER_API_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+Get your API key from [openrouter.ai/keys](https://openrouter.ai/keys).
+
+## Available Tools
+
+- **`list_models`** - List models with optional filters (provider, context, modality, pricing, capabilities)
+- **`search_models`** - Semantic search across models using natural language
+- **`get_model`** - Get complete model details and specifications
+- **`compare_models`** - Compare 2-10 models side-by-side
+- **`recommend_model`** - Get AI-powered model recommendations for use cases
+- **`test_model`** - Run live tests against models via OpenRouter API (requires API key)
+
+## License
+
+MIT © [Index9](https://index9.dev)
+
+## Related
+
+- [Index9](https://index9.dev) - AI model registry and testing platform
+- [Model Context Protocol](https://modelcontextprotocol.io/) - The protocol this server implements

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAMA,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { logger } from "./logger.js";
+import { startMCPServer } from "./mcp.js";
+// Export types for library usage
+export * from "./types/index.js";
+async function main() {
+    logger.info("Starting index9 MCP server");
+    await startMCPServer();
+}
+process.on("unhandledRejection", (error) => {
+    logger.error({
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+    }, "Unhandled rejection");
+    process.exit(1);
+});
+process.on("uncaughtException", (error) => {
+    logger.error({
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+    }, "Uncaught exception");
+    process.exit(1);
+});
+main().catch((error) => {
+    logger.error({
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+    }, "Failed to start");
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@index9/mcp",
+  "version": "1.0.0",
+  "description": "Give your AI assistant up-to-date model knowledge. 1000+ models with real-time pricing, context windows, and capabilities. Latest data, instant responses, zero cost.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "models",
+    "pricing",
+    "capabilities",
+    "context-window",
+    "real-time",
+    "api",
+    "sdk",
+    "openrouter"
+  ],
+  "homepage": "https://index9.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/index9-org/mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/index9-org/mcp/issues"
+  },
+  "license": "MIT",
+  "author": "Index9 <hello@index9.dev>",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "index9": "./dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.2",
+    "axios": "^1.13.2",
+    "pino": "^10.1.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "pino-pretty": "^13.1.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "dev": "tsx watch --env-file=.env src/index.ts",
+    "publish:beta": "pnpm publish --tag beta",
+    "publish:prod": "pnpm publish --tag latest"
+  }
+}