@xyd-js/mcp-server 0.0.0-build-9f87f13-20250930210637

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @xyd-js/mcp-server
+
+## 0.0.0-build-9f87f13-20250930210637
+
+### Patch Changes
+
+- update all packages
+- Updated dependencies
+  - @xyd-js/mcp@0.0.0-build-9f87f13-20250930210637

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) LiveSession Sp.z.o.o
+
+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,89 @@
+# @xyd-js/mcp-server
+
+HTTP MCP server for the xyd ecosystem. Serves Model Context Protocol endpoints over HTTP and wires tools/resources from a Uniform source (OpenAPI or GraphQL).
+
+Powered by `express` and `@modelcontextprotocol/sdk` with support for the MCP Inspector.
+
+## Install
+
+```bash
+bun install
+```
+
+## Usage
+
+Build the server and run it, pointing to a Uniform source file. The server binds to `PORT` (default `3000`).
+
+```bash
+# Build
+bun run build
+
+# Start (OpenAPI)
+PORT=3000 bun run start ./demo/simple/openapi.json
+
+# Or with GraphQL schema
+# PORT=3000 bun run start ./path/to/schema.graphql
+```
+
+The server exposes:
+
+- `POST /mcp` — bidirectional MCP endpoint
+- `GET /mcp` and `DELETE /mcp` — session management via `StreamableHTTPServerTransport`
+
+Pass a bearer token on the first `POST /mcp` initialize request to enable authenticated outgoing requests for generated tools:
+
+```
+Authorization: Bearer <your-api-token>
+```
+
+### Inspector
+
+You can attach the MCP Inspector to a running server instance:
+
+```bash
+npx @modelcontextprotocol/inspector http://localhost:3000/mcp
+```
+
+### Demos
+
+There is a small demo API under `demo/simple` and an accompanying OpenAPI document `demo/simple/openapi.json` you can use for local testing.
+
+```bash
+# Run demo API (separate terminal)
+PORT=5050 bun demo/simple/server.ts
+
+# Start MCP server using demo OpenAPI
+PORT=3000 bun run start ./demo/simple/openapi.json
+
+# Open MCP Inspector
+npx @modelcontextprotocol/inspector http://localhost:3000/mcp
+```
+
+### Programmatic
+
+You can also import and run the server programmatically:
+
+```ts
+import { MCPServer } from "@xyd-js/mcp-server";
+
+const server = new MCPServer();
+// Optionally pass Uniform source as argv[2] when starting the process
+// or customize the class to set `uniformSource`.
+```
+
+## Endpoints and Behavior
+
+- Stores a session-specific bearer token on initialization and uses it for tool requests
+- Registers API reference resources and tools if `uniformSource` is provided
+- Cleans up transports and tokens on session close
+
+## Scripts
+
+Useful package scripts:
+
+- `bun run build` — build to `dist/`
+- `bun run dev` — watch `src/index.ts`
+- `bun run start` — run compiled `dist/index.js`
+- `bun run demo:simple` — watch demo API server (port 5050)
+- `bun run mcp:inspector` — open MCP Inspector pointing at `http://localhost:3000/mcp`
+

package/bin/xyd-mcp-server.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import('../dist/index.js');
+
+

package/demo/client/client.ts

@@ -0,0 +1,94 @@
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+
+export class XydMcpClient {
+  private client: Client;
+  private transport: StreamableHTTPClientTransport;
+  private sessionId: string | null = null;
+
+  constructor(private serverUrl: string = "http://localhost:3000/mcp") {
+    this.transport = new StreamableHTTPClientTransport(new URL(this.serverUrl));
+    this.client = new Client(
+      {
+        name: "xyd-mcp-client",
+        version: "1.0.0",
+      },
+      {
+        capabilities: {
+          tools: {},
+          resources: {},
+        },
+      }
+    );
+  }
+
+  async connect(): Promise<void> {
+    try {
+      await this.client.connect(this.transport);
+      console.log("✅ Connected to MCP server");
+    } catch (error) {
+      console.error("❌ Failed to connect to MCP server:", error);
+      throw error;
+    }
+  }
+
+  async listTools(): Promise<any[]> {
+    try {
+      const response = await this.client.listTools();
+      console.log("🔧 Available tools:", response.tools);
+      return response.tools;
+    } catch (error) {
+      console.error("❌ Failed to list tools:", error);
+      throw error;
+    }
+  }
+
+  async listResources(): Promise<any[]> {
+    try {
+      const response = await this.client.listResources();
+      console.log("📚 Available resources:", response.resources);
+      return response.resources;
+    } catch (error) {
+      console.error("❌ Failed to list resources:", error);
+      throw error;
+    }
+  }
+
+  async callTool(name: string, args: any): Promise<any> {
+    try {
+      console.log(`🔧 Calling tool "${name}" with args:`, args);
+      const response = await this.client.callTool({ name, arguments: args });
+      console.log(`✅ Tool "${name}" response:`, response);
+      return response;
+    } catch (error) {
+      console.error(`❌ Failed to call tool "${name}":`, error);
+      throw error;
+    }
+  }
+
+  async readResource(uri: string): Promise<any> {
+    try {
+      console.log(`📖 Reading resource: ${uri}`);
+      const response = await this.client.readResource({ uri });
+      console.log(`✅ Resource content:`, response);
+      return response;
+    } catch (error) {
+      console.error(`❌ Failed to read resource "${uri}":`, error);
+      throw error;
+    }
+  }
+
+  async disconnect(): Promise<void> {
+    try {
+      await this.client.close();
+      console.log("🔌 Disconnected from MCP server");
+    } catch (error) {
+      console.error("❌ Failed to disconnect:", error);
+      throw error;
+    }
+  }
+
+  getSessionId(): string | undefined {
+    return this.transport.sessionId;
+  }
+}