vibeindex-mcp 1.0.0

package/README.md

@@ -0,0 +1,127 @@
+# Vibe Index MCP Server
+
+Claude Code에서 [Vibe Index](https://vibeindex.ai)의 스킬, 플러그인, MCP 서버를 검색하고 설치할 수 있는 MCP 서버입니다.
+
+## 설치
+
+### Claude Desktop
+
+`claude_desktop_config.json`에 추가:
+
+```json
+{
+  "mcpServers": {
+    "vibeindex": {
+      "command": "npx",
+      "args": ["-y", "@vibeindex/mcp-server"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+`.claude/settings.json`에 추가:
+
+```json
+{
+  "mcpServers": {
+    "vibeindex": {
+      "command": "npx",
+      "args": ["-y", "@vibeindex/mcp-server"]
+    }
+  }
+}
+```
+
+## 사용 가능한 도구
+
+### search
+리소스 검색
+
+```
+"git 관련 스킬 찾아줘"
+"database MCP 서버 검색해줘"
+```
+
+**파라미터:**
+- `query` (필수): 검색어
+- `type` (선택): all, skill, plugin, mcp, marketplace
+- `limit` (선택): 결과 개수 (기본 10, 최대 20)
+
+### trending
+트렌딩 리소스 조회
+
+```
+"요즘 인기있는 스킬 뭐야?"
+"이번 주 트렌딩 보여줘"
+```
+
+**파라미터:**
+- `period` (선택): day, week, month (기본 week)
+- `limit` (선택): 결과 개수 (기본 10)
+
+### top
+스타 순 상위 리소스
+
+```
+"가장 인기있는 MCP 서버 알려줘"
+"스타 많은 플러그인 top 5"
+```
+
+**파라미터:**
+- `type` (선택): all, skill, plugin, mcp, marketplace
+- `limit` (선택): 결과 개수 (기본 10)
+
+### install
+설치 명령어 조회
+
+```
+"commit-message 스킬 설치 방법 알려줘"
+```
+
+**파라미터:**
+- `name` (필수): 리소스 이름
+- `type` (선택): 리소스 타입
+
+### categories
+카테고리 및 태그 목록
+
+```
+"어떤 카테고리가 있어?"
+```
+
+## 예시
+
+Claude Code에서:
+
+```
+User: git 관련 스킬 찾아줘
+Claude: [search 도구 사용] 검색 결과를 보여드립니다...
+
+User: 그 중에 commit-message 설치해줘
+Claude: [install 도구 사용] 설치 명령어입니다:
+        claude skill add owner/repo/commit-message
+```
+
+## 개발
+
+```bash
+# 의존성 설치
+npm install
+
+# 빌드
+npm run build
+
+# 개발 모드 (watch)
+npm run dev
+```
+
+## 라이선스
+
+MIT
+
+## 링크
+
+- [Vibe Index](https://vibeindex.ai)
+- [GitHub](https://github.com/vibeindex/mcp-server)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const API_BASE = "https://vibeindex.ai/api";
+// Helper to fetch from Vibe Index API
+async function fetchAPI(endpoint) {
+    const response = await fetch(`${API_BASE}${endpoint}`);
+    if (!response.ok) {
+        throw new Error(`API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+// Generate install command based on resource type
+function getInstallCommand(resource) {
+    const { resource_type, github_owner, github_repo, name } = resource;
+    switch (resource_type) {
+        case "skill":
+            return `claude skill add ${github_owner}/${github_repo}/${name}`;
+        case "plugin":
+            return `claude plugin add ${github_owner}/${github_repo}`;
+        case "mcp":
+            return `# Add to claude_desktop_config.json or .claude/settings.json
+# See: ${resource.github_url}`;
+        case "marketplace":
+            return `# Browse marketplace: https://vibeindex.ai/marketplaces/${github_owner}/${github_repo}`;
+        default:
+            return `# See: ${resource.github_url}`;
+    }
+}
+// Format resource for display
+function formatResource(resource, includeInstall = false) {
+    const typeEmoji = {
+        skill: "🎯",
+        plugin: "🔌",
+        mcp: "🔗",
+        marketplace: "🏪",
+    };
+    const lines = [
+        `${typeEmoji[resource.resource_type] || "📦"} **${resource.name}**`,
+        `   Type: ${resource.resource_type}${resource.is_official ? " (Official)" : ""}`,
+        `   Stars: ⭐ ${resource.stars.toLocaleString()}`,
+        `   Repo: ${resource.github_owner}/${resource.github_repo}`,
+        `   Description: ${resource.description || "No description"}`,
+    ];
+    if (resource.tags?.length > 0) {
+        lines.push(`   Tags: ${resource.tags.slice(0, 5).join(", ")}`);
+    }
+    if (includeInstall) {
+        lines.push(`   Install: \`${getInstallCommand(resource)}\``);
+    }
+    lines.push(`   URL: https://vibeindex.ai/${resource.resource_type}s/${resource.github_owner}/${resource.github_repo}/${resource.name}`);
+    return lines.join("\n");
+}
+// Create MCP server
+const server = new McpServer({
+    name: "vibeindex",
+    version: "1.0.0",
+});
+// Tool: Search resources
+server.tool("search", "Search for Claude Code skills, plugins, MCP servers, and marketplaces on Vibe Index", {
+    query: z.string().describe("Search query (e.g., 'git', 'database', 'docker')"),
+    type: z
+        .enum(["all", "skill", "plugin", "mcp", "marketplace"])
+        .optional()
+        .describe("Filter by resource type (default: all)"),
+    limit: z
+        .number()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe("Number of results to return (default: 10, max: 20)"),
+}, async ({ query, type = "all", limit = 10 }) => {
+    try {
+        const typeFilter = type !== "all" ? `&type=${type}` : "";
+        const data = await fetchAPI(`/resources?search=${encodeURIComponent(query)}${typeFilter}&pageSize=${limit}`);
+        if (data.data.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No results found for "${query}"${type !== "all" ? ` in ${type}s` : ""}. Try different keywords or browse at https://vibeindex.ai`,
+                    },
+                ],
+            };
+        }
+        const results = data.data.map((r) => formatResource(r, true)).join("\n\n---\n\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## Search Results for "${query}" (${data.total} total)\n\n${results}\n\n---\nBrowse more at https://vibeindex.ai/search?q=${encodeURIComponent(query)}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error searching: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Get trending/rising resources
+server.tool("trending", "Get trending and rising Claude Code resources from Vibe Index", {
+    period: z
+        .enum(["day", "week", "month"])
+        .optional()
+        .describe("Time period for trending (default: week)"),
+    limit: z
+        .number()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe("Number of results (default: 10)"),
+}, async ({ period = "week", limit = 10 }) => {
+    try {
+        const data = await fetchAPI(`/rising-stars?period=${period}&limit=${limit}`);
+        if (!data.rising || data.rising.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No trending resources found for the past ${period}. Check https://vibeindex.ai for the latest.`,
+                    },
+                ],
+            };
+        }
+        const periodLabel = { day: "24 hours", week: "week", month: "month" }[period];
+        const results = data.rising
+            .map((r, i) => {
+            const base = formatResource(r, true);
+            return `**#${i + 1}** (+${r.stars_today} stars this ${period})\n${base}`;
+        })
+            .join("\n\n---\n\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## 🔥 Trending Resources (Past ${periodLabel})\n\n${results}\n\n---\nSee full rankings at https://vibeindex.ai`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error fetching trending: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Get top resources by stars
+server.tool("top", "Get top Claude Code resources by stars", {
+    type: z
+        .enum(["all", "skill", "plugin", "mcp", "marketplace"])
+        .optional()
+        .describe("Filter by resource type (default: all)"),
+    limit: z
+        .number()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe("Number of results (default: 10)"),
+}, async ({ type = "all", limit = 10 }) => {
+    try {
+        const typeFilter = type !== "all" ? `&type=${type}` : "";
+        const data = await fetchAPI(`/resources?sort=stars${typeFilter}&pageSize=${limit}`);
+        if (data.data.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No resources found. Check https://vibeindex.ai`,
+                    },
+                ],
+            };
+        }
+        const typeLabel = type === "all" ? "Resources" : `${type}s`;
+        const results = data.data
+            .map((r, i) => `**#${i + 1}**\n${formatResource(r, true)}`)
+            .join("\n\n---\n\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## ⭐ Top ${typeLabel} by Stars\n\n${results}\n\n---\nBrowse all at https://vibeindex.ai/browse?sort=stars${type !== "all" ? `&type=${type}` : ""}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error fetching top resources: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Get install command
+server.tool("install", "Get the install command for a Claude Code resource", {
+    name: z.string().describe("Resource name to get install command for"),
+    type: z
+        .enum(["skill", "plugin", "mcp", "marketplace"])
+        .optional()
+        .describe("Resource type (helps find exact match)"),
+}, async ({ name, type }) => {
+    try {
+        const typeFilter = type ? `&type=${type}` : "";
+        const data = await fetchAPI(`/resources?search=${encodeURIComponent(name)}${typeFilter}&pageSize=5`);
+        // Find exact or close match
+        const exactMatch = data.data.find((r) => r.name.toLowerCase() === name.toLowerCase());
+        const resource = exactMatch || data.data[0];
+        if (!resource) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Resource "${name}" not found. Try searching with: search "${name}"`,
+                    },
+                ],
+            };
+        }
+        const installCmd = getInstallCommand(resource);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `## Install ${resource.name}\n\n**Type:** ${resource.resource_type}\n**Repository:** ${resource.github_owner}/${resource.github_repo}\n\n**Install Command:**\n\`\`\`bash\n${installCmd}\n\`\`\`\n\n**More info:** https://vibeindex.ai/${resource.resource_type}s/${resource.github_owner}/${resource.github_repo}/${resource.name}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Tool: Browse categories
+server.tool("categories", "List available categories and tags for Claude Code resources", {}, async () => {
+    const categories = {
+        "Resource Types": [
+            "🎯 Skills - Reusable agent capabilities",
+            "🔌 Plugins - Extend Claude Code functionality",
+            "🔗 MCP Servers - Model Context Protocol integrations",
+            "🏪 Marketplaces - Collections of plugins/skills",
+        ],
+        "Popular Tags": [
+            "git, github - Version control",
+            "database, sql, postgres - Data management",
+            "docker, kubernetes - Containers & orchestration",
+            "aws, gcp, azure - Cloud platforms",
+            "react, vue, nextjs - Frontend frameworks",
+            "python, typescript, rust - Programming languages",
+            "testing, lint, ci-cd - Development tools",
+            "ai, llm, openai - AI/ML tools",
+        ],
+    };
+    const text = Object.entries(categories)
+        .map(([cat, items]) => `### ${cat}\n${items.map((i) => `- ${i}`).join("\n")}`)
+        .join("\n\n");
+    return {
+        content: [
+            {
+                type: "text",
+                text: `## Vibe Index Categories\n\n${text}\n\n---\nUse \`search <keyword>\` to find resources in any category.\nBrowse all at https://vibeindex.ai/explore`,
+            },
+        ],
+    };
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Vibe Index MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "vibeindex-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Vibe Index - search Claude Code skills, plugins, and MCP servers",
+  "main": "dist/index.js",
+  "bin": {
+    "vibeindex-mcp": "./dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "claude-code",
+    "vibeindex",
+    "skills",
+    "plugins"
+  ],
+  "author": "JoLab",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const API_BASE = "https://vibeindex.ai/api";
+
+interface Resource {
+  id: string;
+  name: string;
+  description: string;
+  description_ko?: string;
+  resource_type: "skill" | "plugin" | "mcp" | "marketplace";
+  github_owner: string;
+  github_repo: string;
+  github_url: string;
+  stars: number;
+  tags: string[];
+  is_official?: boolean;
+  install_command?: string;
+}
+
+interface SearchResponse {
+  data: Resource[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+interface TrendingResponse {
+  rising: Array<Resource & { stars_today: number; trending_rank: number }>;
+  period: string;
+}
+
+// Helper to fetch from Vibe Index API
+async function fetchAPI<T>(endpoint: string): Promise<T> {
+  const response = await fetch(`${API_BASE}${endpoint}`);
+  if (!response.ok) {
+    throw new Error(`API error: ${response.status} ${response.statusText}`);
+  }
+  return response.json() as Promise<T>;
+}
+
+// Generate install command based on resource type
+function getInstallCommand(resource: Resource): string {
+  const { resource_type, github_owner, github_repo, name } = resource;
+
+  switch (resource_type) {
+    case "skill":
+      return `claude skill add ${github_owner}/${github_repo}/${name}`;
+    case "plugin":
+      return `claude plugin add ${github_owner}/${github_repo}`;
+    case "mcp":
+      return `# Add to claude_desktop_config.json or .claude/settings.json
+# See: ${resource.github_url}`;
+    case "marketplace":
+      return `# Browse marketplace: https://vibeindex.ai/marketplaces/${github_owner}/${github_repo}`;
+    default:
+      return `# See: ${resource.github_url}`;
+  }
+}
+
+// Format resource for display
+function formatResource(resource: Resource, includeInstall = false): string {
+  const typeEmoji: Record<string, string> = {
+    skill: "🎯",
+    plugin: "🔌",
+    mcp: "🔗",
+    marketplace: "🏪",
+  };
+
+  const lines = [
+    `${typeEmoji[resource.resource_type] || "📦"} **${resource.name}**`,
+    `   Type: ${resource.resource_type}${resource.is_official ? " (Official)" : ""}`,
+    `   Stars: ⭐ ${resource.stars.toLocaleString()}`,
+    `   Repo: ${resource.github_owner}/${resource.github_repo}`,
+    `   Description: ${resource.description || "No description"}`,
+  ];
+
+  if (resource.tags?.length > 0) {
+    lines.push(`   Tags: ${resource.tags.slice(0, 5).join(", ")}`);
+  }
+
+  if (includeInstall) {
+    lines.push(`   Install: \`${getInstallCommand(resource)}\``);
+  }
+
+  lines.push(`   URL: https://vibeindex.ai/${resource.resource_type}s/${resource.github_owner}/${resource.github_repo}/${resource.name}`);
+
+  return lines.join("\n");
+}
+
+// Create MCP server
+const server = new McpServer({
+  name: "vibeindex",
+  version: "1.0.0",
+});
+
+// Tool: Search resources
+server.tool(
+  "search",
+  "Search for Claude Code skills, plugins, MCP servers, and marketplaces on Vibe Index",
+  {
+    query: z.string().describe("Search query (e.g., 'git', 'database', 'docker')"),
+    type: z
+      .enum(["all", "skill", "plugin", "mcp", "marketplace"])
+      .optional()
+      .describe("Filter by resource type (default: all)"),
+    limit: z
+      .number()
+      .min(1)
+      .max(20)
+      .optional()
+      .describe("Number of results to return (default: 10, max: 20)"),
+  },
+  async ({ query, type = "all", limit = 10 }) => {
+    try {
+      const typeFilter = type !== "all" ? `&type=${type}` : "";
+      const data = await fetchAPI<SearchResponse>(
+        `/resources?search=${encodeURIComponent(query)}${typeFilter}&pageSize=${limit}`
+      );
+
+      if (data.data.length === 0) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `No results found for "${query}"${type !== "all" ? ` in ${type}s` : ""}. Try different keywords or browse at https://vibeindex.ai`,
+            },
+          ],
+        };
+      }
+
+      const results = data.data.map((r) => formatResource(r, true)).join("\n\n---\n\n");
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `## Search Results for "${query}" (${data.total} total)\n\n${results}\n\n---\nBrowse more at https://vibeindex.ai/search?q=${encodeURIComponent(query)}`,
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Error searching: ${error instanceof Error ? error.message : "Unknown error"}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+);
+
+// Tool: Get trending/rising resources
+server.tool(
+  "trending",
+  "Get trending and rising Claude Code resources from Vibe Index",
+  {
+    period: z
+      .enum(["day", "week", "month"])
+      .optional()
+      .describe("Time period for trending (default: week)"),
+    limit: z
+      .number()
+      .min(1)
+      .max(20)
+      .optional()
+      .describe("Number of results (default: 10)"),
+  },
+  async ({ period = "week", limit = 10 }) => {
+    try {
+      const data = await fetchAPI<TrendingResponse>(
+        `/rising-stars?period=${period}&limit=${limit}`
+      );
+
+      if (!data.rising || data.rising.length === 0) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `No trending resources found for the past ${period}. Check https://vibeindex.ai for the latest.`,
+            },
+          ],
+        };
+      }
+
+      const periodLabel = { day: "24 hours", week: "week", month: "month" }[period];
+      const results = data.rising
+        .map((r, i) => {
+          const base = formatResource(r, true);
+          return `**#${i + 1}** (+${r.stars_today} stars this ${period})\n${base}`;
+        })
+        .join("\n\n---\n\n");
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `## 🔥 Trending Resources (Past ${periodLabel})\n\n${results}\n\n---\nSee full rankings at https://vibeindex.ai`,
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Error fetching trending: ${error instanceof Error ? error.message : "Unknown error"}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+);
+
+// Tool: Get top resources by stars
+server.tool(
+  "top",
+  "Get top Claude Code resources by stars",
+  {
+    type: z
+      .enum(["all", "skill", "plugin", "mcp", "marketplace"])
+      .optional()
+      .describe("Filter by resource type (default: all)"),
+    limit: z
+      .number()
+      .min(1)
+      .max(20)
+      .optional()
+      .describe("Number of results (default: 10)"),
+  },
+  async ({ type = "all", limit = 10 }) => {
+    try {
+      const typeFilter = type !== "all" ? `&type=${type}` : "";
+      const data = await fetchAPI<SearchResponse>(
+        `/resources?sort=stars${typeFilter}&pageSize=${limit}`
+      );
+
+      if (data.data.length === 0) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `No resources found. Check https://vibeindex.ai`,
+            },
+          ],
+        };
+      }
+
+      const typeLabel = type === "all" ? "Resources" : `${type}s`;
+      const results = data.data
+        .map((r, i) => `**#${i + 1}**\n${formatResource(r, true)}`)
+        .join("\n\n---\n\n");
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `## ⭐ Top ${typeLabel} by Stars\n\n${results}\n\n---\nBrowse all at https://vibeindex.ai/browse?sort=stars${type !== "all" ? `&type=${type}` : ""}`,
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Error fetching top resources: ${error instanceof Error ? error.message : "Unknown error"}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+);
+
+// Tool: Get install command
+server.tool(
+  "install",
+  "Get the install command for a Claude Code resource",
+  {
+    name: z.string().describe("Resource name to get install command for"),
+    type: z
+      .enum(["skill", "plugin", "mcp", "marketplace"])
+      .optional()
+      .describe("Resource type (helps find exact match)"),
+  },
+  async ({ name, type }) => {
+    try {
+      const typeFilter = type ? `&type=${type}` : "";
+      const data = await fetchAPI<SearchResponse>(
+        `/resources?search=${encodeURIComponent(name)}${typeFilter}&pageSize=5`
+      );
+
+      // Find exact or close match
+      const exactMatch = data.data.find(
+        (r) => r.name.toLowerCase() === name.toLowerCase()
+      );
+      const resource = exactMatch || data.data[0];
+
+      if (!resource) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Resource "${name}" not found. Try searching with: search "${name}"`,
+            },
+          ],
+        };
+      }
+
+      const installCmd = getInstallCommand(resource);
+
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `## Install ${resource.name}\n\n**Type:** ${resource.resource_type}\n**Repository:** ${resource.github_owner}/${resource.github_repo}\n\n**Install Command:**\n\`\`\`bash\n${installCmd}\n\`\`\`\n\n**More info:** https://vibeindex.ai/${resource.resource_type}s/${resource.github_owner}/${resource.github_repo}/${resource.name}`,
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `Error: ${error instanceof Error ? error.message : "Unknown error"}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+);
+
+// Tool: Browse categories
+server.tool(
+  "categories",
+  "List available categories and tags for Claude Code resources",
+  {},
+  async () => {
+    const categories = {
+      "Resource Types": [
+        "🎯 Skills - Reusable agent capabilities",
+        "🔌 Plugins - Extend Claude Code functionality",
+        "🔗 MCP Servers - Model Context Protocol integrations",
+        "🏪 Marketplaces - Collections of plugins/skills",
+      ],
+      "Popular Tags": [
+        "git, github - Version control",
+        "database, sql, postgres - Data management",
+        "docker, kubernetes - Containers & orchestration",
+        "aws, gcp, azure - Cloud platforms",
+        "react, vue, nextjs - Frontend frameworks",
+        "python, typescript, rust - Programming languages",
+        "testing, lint, ci-cd - Development tools",
+        "ai, llm, openai - AI/ML tools",
+      ],
+    };
+
+    const text = Object.entries(categories)
+      .map(([cat, items]) => `### ${cat}\n${items.map((i) => `- ${i}`).join("\n")}`)
+      .join("\n\n");
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: `## Vibe Index Categories\n\n${text}\n\n---\nUse \`search <keyword>\` to find resources in any category.\nBrowse all at https://vibeindex.ai/explore`,
+        },
+      ],
+    };
+  }
+);
+
+// Start server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Vibe Index MCP Server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}