@ai-ide-bridge/mcp 1.0.2

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ai-ide-bridge/mcp@1.0.2 build /home/runner/work/llm-bridge/llm-bridge/packages/mcp
+> tsc
+

package/README.md

@@ -0,0 +1,44 @@
+# @ai-ide-bridge/mcp
+
+The Model Context Protocol (MCP) server for **AI IDE Bridge**.
+
+AI IDE Bridge is a local HTTP server that translates OpenAI-compatible API requests into provider-specific calls, enabling any OpenAI-format client to use any AI IDE's model catalog.
+
+## Overview
+
+`@ai-ide-bridge/mcp` implements an MCP server over stdio, enabling direct integration with AI IDEs like Cursor. It exposes bridge status, model catalogs, and client configuration generation as MCP tools.
+
+## Installation
+
+```bash
+npm install @ai-ide-bridge/mcp
+```
+
+## Usage
+
+Configure the MCP server in your AI IDE (e.g., Cursor MCP settings):
+
+```json
+{
+  "mcpServers": {
+    "llm-bridge": {
+      "command": "npx",
+      "args": ["-y", "@ai-ide-bridge/mcp"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+- `bridge_status` — Check bridge health and active plugins.
+- `list_models` — Retrieve available models from all active plugins.
+- `generate_opencode_config` — Generate provider configuration fragments for OpenCode.
+
+## Documentation
+
+For full documentation and setup instructions, please visit the main repository: [https://github.com/aeswibon/llm-bridge](https://github.com/aeswibon/llm-bridge).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { createMcpServer } from './server.js';

package/dist/index.js

@@ -0,0 +1 @@
+export { createMcpServer } from './server.js';

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createMcpServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,86 @@
+#!/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 BRIDGE_PORT = Number(process.env.LLM_BRIDGE_PORT ?? '3849');
+const BRIDGE_HOST = process.env.LLM_BRIDGE_HOST ?? '127.0.0.1';
+function bridgeUrl(path) {
+    return `http://${BRIDGE_HOST}:${BRIDGE_PORT}${path}`;
+}
+export function createMcpServer() {
+    const server = new McpServer({ name: 'llm-bridge-mcp', version: '2.0.0' }, {
+        instructions: 'Manage llm-bridge: check status, list models, generate OpenCode config.',
+    });
+    server.registerTool('bridge_status', { description: 'Check llm-bridge server health and status.' }, async () => {
+        try {
+            const res = await fetch(bridgeUrl('/health'));
+            const body = await res.json();
+            if (res.ok) {
+                return { content: [{ type: 'text', text: JSON.stringify(body, null, 2) }] };
+            }
+            return { content: [{ type: 'text', text: `Bridge unhealthy: status ${res.status}` }] };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { content: [{ type: 'text', text: `Cannot reach bridge: ${msg}` }] };
+        }
+    });
+    server.registerTool('list_models', { description: 'List available models from the active provider.' }, async () => {
+        try {
+            const res = await fetch(bridgeUrl('/v1/models'));
+            const body = await res.json();
+            if (res.ok) {
+                const modelIds = body.data?.map((m) => m.id) ?? [];
+                return { content: [{ type: 'text', text: `Available models: ${modelIds.join(', ')}` }] };
+            }
+            return {
+                content: [{ type: 'text', text: `Failed to list models: ${JSON.stringify(body)}` }],
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return { content: [{ type: 'text', text: `Cannot reach bridge: ${msg}` }] };
+        }
+    });
+    server.registerTool('generate_opencode_config', {
+        description: 'Generate an OpenCode provider fragment for the bridge.',
+        inputSchema: {
+            providerId: z.string().optional().describe('Provider key (default: llm-bridge).'),
+            modelId: z.string().optional().describe('Model id (default: composer-2).'),
+        },
+    }, async ({ providerId, modelId }) => {
+        const pid = providerId ?? 'llm-bridge';
+        const mid = modelId ?? 'composer-2';
+        const fragment = {
+            provider: {
+                [pid]: {
+                    npm: '@ai-sdk/openai-compatible',
+                    name: 'LLM Bridge',
+                    options: {
+                        apiKey: 'bridge-local',
+                        baseURL: bridgeUrl('/v1'),
+                    },
+                    models: { [mid]: { name: mid } },
+                },
+            },
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Merge into opencode.json:\n\n${JSON.stringify(fragment, null, 2)}`,
+                },
+            ],
+        };
+    });
+    return server;
+}
+async function main() {
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+const entry = process.argv[1];
+if (entry && new URL(import.meta.url).pathname.endsWith(entry.split('/').pop())) {
+    void main();
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@ai-ide-bridge/mcp",
+  "version": "1.0.2",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "llm-bridge-mcp": "./dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { createMcpServer } from './server.js';

package/src/server.ts

@@ -0,0 +1,108 @@
+#!/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 BRIDGE_PORT = Number(process.env.LLM_BRIDGE_PORT ?? '3849');
+const BRIDGE_HOST = process.env.LLM_BRIDGE_HOST ?? '127.0.0.1';
+
+function bridgeUrl(path: string): string {
+  return `http://${BRIDGE_HOST}:${BRIDGE_PORT}${path}`;
+}
+
+export function createMcpServer(): McpServer {
+  const server = new McpServer(
+    { name: 'llm-bridge-mcp', version: '2.0.0' },
+    {
+      instructions: 'Manage llm-bridge: check status, list models, generate OpenCode config.',
+    },
+  );
+
+  server.registerTool(
+    'bridge_status',
+    { description: 'Check llm-bridge server health and status.' },
+    async () => {
+      try {
+        const res = await fetch(bridgeUrl('/health'));
+        const body = await res.json();
+        if (res.ok) {
+          return { content: [{ type: 'text', text: JSON.stringify(body, null, 2) }] };
+        }
+        return { content: [{ type: 'text', text: `Bridge unhealthy: status ${res.status}` }] };
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: 'text', text: `Cannot reach bridge: ${msg}` }] };
+      }
+    },
+  );
+
+  server.registerTool(
+    'list_models',
+    { description: 'List available models from the active provider.' },
+    async () => {
+      try {
+        const res = await fetch(bridgeUrl('/v1/models'));
+        const body = await res.json();
+        if (res.ok) {
+          const modelIds = body.data?.map((m: any) => m.id) ?? [];
+          return { content: [{ type: 'text', text: `Available models: ${modelIds.join(', ')}` }] };
+        }
+        return {
+          content: [{ type: 'text', text: `Failed to list models: ${JSON.stringify(body)}` }],
+        };
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { content: [{ type: 'text', text: `Cannot reach bridge: ${msg}` }] };
+      }
+    },
+  );
+
+  server.registerTool(
+    'generate_opencode_config',
+    {
+      description: 'Generate an OpenCode provider fragment for the bridge.',
+      inputSchema: {
+        providerId: z.string().optional().describe('Provider key (default: llm-bridge).'),
+        modelId: z.string().optional().describe('Model id (default: composer-2).'),
+      },
+    },
+    async ({ providerId, modelId }) => {
+      const pid = providerId ?? 'llm-bridge';
+      const mid = modelId ?? 'composer-2';
+      const fragment = {
+        provider: {
+          [pid]: {
+            npm: '@ai-sdk/openai-compatible',
+            name: 'LLM Bridge',
+            options: {
+              apiKey: 'bridge-local',
+              baseURL: bridgeUrl('/v1'),
+            },
+            models: { [mid]: { name: mid } },
+          },
+        },
+      };
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Merge into opencode.json:\n\n${JSON.stringify(fragment, null, 2)}`,
+          },
+        ],
+      };
+    },
+  );
+
+  return server;
+}
+
+async function main(): Promise<void> {
+  const server = createMcpServer();
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+const entry = process.argv[1];
+if (entry && new URL(import.meta.url).pathname.endsWith(entry.split('/').pop()!)) {
+  void main();
+}

package/test/server.test.ts

@@ -0,0 +1,14 @@
+import { describe, it, expect } from 'vitest';
+import { createMcpServer } from '../src/server.js';
+
+describe('MCP Server', () => {
+  it('creates server instance', () => {
+    const server = createMcpServer();
+    expect(server).toBeDefined();
+  });
+
+  it('has correct name and version', () => {
+    const server = createMcpServer();
+    expect(server).toBeDefined();
+  });
+});

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*.ts"]
+}