@ampeco/public-api-mcp 0.2.2 → 0.3.0

package/dist/server/resources/native.js

@@ -0,0 +1,31 @@
+/**
+ * Native MCP resources registration
+ * Uses the shared ResourceHandler to avoid code duplication
+ */
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { ResourceHandler } from './handlers.js';
+/**
+ * Register native MCP resources using the shared ResourceHandler
+ */
+export function registerNativeResources(server, endpoints) {
+    const handler = new ResourceHandler(endpoints);
+    // Register resources/list handler - delegates to shared handler
+    server.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        const resources = handler.listTags();
+        return { resources };
+    });
+    // Register resources/read handler - delegates to shared handler
+    server.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const data = handler.readResource(request.params.uri);
+        return {
+            contents: [
+                {
+                    uri: request.params.uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=native.js.map

package/dist/server/resources/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../src/server/resources/native.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,SAAsB;IAC/E,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAE/C,gEAAgE;IAChE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,gEAAgE;IAChE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEtD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG;oBACvB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/resources/tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool emulation for MCP resources
+ * Uses the shared ResourceHandler to avoid code duplication
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BuildOutput } from '../../build/types.js';
+/**
+ * Register tool emulation using the shared ResourceHandler
+ */
+export declare function registerEmulationTools(server: McpServer, endpoints: BuildOutput): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/server/resources/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/server/resources/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CA4CtF"}

package/dist/server/resources/tools.js

@@ -0,0 +1,41 @@
+/**
+ * Tool emulation for MCP resources
+ * Uses the shared ResourceHandler to avoid code duplication
+ */
+import { z } from 'zod';
+import { ResourceHandler } from './handlers.js';
+/**
+ * Register tool emulation using the shared ResourceHandler
+ */
+export function registerEmulationTools(server, endpoints) {
+    const handler = new ResourceHandler(endpoints);
+    // Tool 1: list_resources - delegates to shared handler
+    server.tool('list_resources', 'List all available API tags. This emulates the native MCP resources/list functionality. Returns a list of tags that group related endpoints together (e.g., Users, ChargingSessions, Connectors). Each tag can then be read using the read_resource tool with tag:// URIs.', {
+    // No parameters - always returns all tags
+    }, async () => {
+        const resources = handler.listTags();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ resources }, null, 2),
+                },
+            ],
+        };
+    });
+    // Tool 2: read_resource - delegates to shared handler
+    server.tool('read_resource', 'Read a specific resource by URI. This emulates the native MCP resources/read functionality. Supports two URI formats: tag://{TagName} to read all endpoints within a tag, and api://{METHOD}{path} to read detailed endpoint specifications. You MUST use this tool to read endpoint definitions before calling api_request.', {
+        uri: z.string().describe('The resource URI to read. Format: tag://{TagName} or api://{METHOD}{path}. Examples: "tag://Users", "api://GET/users/{id}", "api://POST/charging-sessions"'),
+    }, async (args) => {
+        const data = handler.readResource(args.uri);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/server/resources/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/server/resources/tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,SAAsB;IAC9E,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IAE/C,uDAAuD;IACvD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,4QAA4Q,EAC5Q;IACE,0CAA0C;KAC3C,EACD,KAAK,IAAI,EAAE;QACT,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAErC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC7C;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sDAAsD;IACtD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,8TAA8T,EAC9T;QACE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4JAA4J,CAAC;KACvL,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE5C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/stdio.d.ts

@@ -2,9 +2,10 @@
  * Stdio MCP Server
  * Runs MCP server with stdio transport for local integrations (Claude Desktop, NPX, etc.)
  */
+import type { StdioServerOptions } from './types.js';
 /**
  * Start MCP server in stdio mode
  * Uses stdin/stdout for communication with MCP clients
  */
-export declare function startStdioServer(bearerToken: string, hostname: string): Promise<void>;
+export declare function startStdioServer(options: StdioServerOptions): Promise<void>;
 //# sourceMappingURL=stdio.d.ts.map

package/dist/server/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/server/stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAiBf"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/server/stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/server/stdio.js

@@ -9,15 +9,21 @@ import { loadEndpoints } from './loader.js';
  * Start MCP server in stdio mode
  * Uses stdin/stdout for communication with MCP clients
  */
-export async function startStdioServer(bearerToken, hostname) {
+export async function startStdioServer(options) {
+    const { bearerToken, hostname, emulateResourcesViaTools = false, } = options;
     console.error('[Stdio Mode] Starting MCP server...');
     const endpoints = loadEndpoints();
     console.error(`[Stdio Mode] Loaded ${endpoints.endpoints.length} endpoints from ${endpoints.info.title} v${endpoints.info.version}`);
-    const server = createServer(endpoints, bearerToken, hostname);
+    const server = createServer(endpoints, {
+        hostname,
+        bearerToken,
+        emulateResourcesViaTools,
+    });
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error('[Stdio Mode] Server connected and ready');
     console.error(`[Stdio Mode] Target API: ${hostname}`);
+    console.error(`[Stdio Mode] Resource mode: ${emulateResourcesViaTools ? 'Tool Emulation' : 'Native Resources'}`);
     console.error(`[Stdio Mode] Bearer token: ${bearerToken ? 'provided' : 'not provided'}`);
     // Keep process alive
     process.stdin.resume();

package/dist/server/stdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/server/stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,QAAgB;IAEhB,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAErD,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,CAAC,SAAS,CAAC,MAAM,mBAAmB,SAAS,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAErI,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,8BAA8B,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzF,qBAAqB;IACrB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/server/stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA2B;IAE3B,MAAM,EACJ,WAAW,EACX,QAAQ,EACR,wBAAwB,GAAG,KAAK,GACjC,GAAG,OAAO,CAAC;IAEZ,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAErD,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,uBAAuB,SAAS,CAAC,SAAS,CAAC,MAAM,mBAAmB,SAAS,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAErI,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE;QACrC,QAAQ;QACR,WAAW;QACX,wBAAwB;KACzB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,+BAA+B,wBAAwB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjH,OAAO,CAAC,KAAK,CAAC,8BAA8B,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzF,qBAAqB;IACrB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;AACzB,CAAC"}

package/dist/server/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Server Configuration Types
+ * Defines options interfaces for server creation and startup functions
+ */
+/**
+ * Options for creating an MCP server instance
+ */
+export interface ServerOptions {
+    /** API hostname to proxy requests to */
+    hostname: string;
+    /** Bearer token for authentication */
+    bearerToken: string;
+    /** Emulate resources via tools instead of native MCP resources */
+    emulateResourcesViaTools?: boolean;
+}
+/**
+ * Options for starting the MCP server in stdio mode
+ */
+export interface StdioServerOptions {
+    /** Bearer token for API authentication */
+    bearerToken: string;
+    /** Target API hostname */
+    hostname: string;
+    /** Emulate resources via tools instead of native MCP resources */
+    emulateResourcesViaTools?: boolean;
+}
+/**
+ * Options for starting the MCP server in HTTP mode
+ */
+export interface HttpServerOptions {
+    /** Port to listen on */
+    port: number;
+    /** Emulate resources via tools instead of native MCP resources (for all requests) */
+    emulateResourcesViaTools?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAMpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAKpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAMpC"}

package/dist/server/types.js

@@ -0,0 +1,6 @@
+/**
+ * Server Configuration Types
+ * Defines options interfaces for server creation and startup functions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampeco/public-api-mcp",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "MCP server that dynamically exposes the AMPECO.CHARGE Public API defined by an OpenAPI 3 specification",
   "type": "module",
   "main": "dist/cli/index.js",
@@ -15,7 +15,8 @@
   ],
   "scripts": {
     "build": "tsx src/build/index.ts \"$OPENAPI_SPEC_PATH\" && tsc && mkdir -p dist/generated && cp src/generated/*.json src/generated/*.ts dist/generated/",
-    "dev:stdio": "(tsx src/build/index.ts \"$OPENAPI_SPEC_PATH\" && echo '[Build] Complete' >&2) >&2 && tsx src/cli/index.ts --stdio --hostname http://demo.charge.alex2.dev.ampeco.tech --token \"$AMPECO_TOKEN\"",
+    "build:silent": "(tsx src/build/index.ts \"$OPENAPI_SPEC_PATH\" && echo '[Build] Complete' >&2) >&2",
+    "dev:stdio": "npm run --silent build:silent && tsx src/cli/index.ts --stdio --hostname http://demo.charge.alex2.dev.ampeco.tech --token \"$AMPECO_TOKEN\"",
     "dev:http": "tsx src/build/index.ts \"$OPENAPI_SPEC_PATH\" && tsx src/cli/index.ts --http --port 3001",
     "dev": "npm run dev:http",
     "start": "node dist/cli/index.js",