gia-mcp-server 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to GIA MCP Server will be documented in this file.
 
+## [0.2.2] - 2026-02-26
+
+### Fixed
+- Proxy no longer crashes when upstream GIA server is unreachable
+- Server stays alive in disconnected mode — returns clear errors on tool calls
+- Local ping responses keep health checks passing (Glama, monitoring)
+- Lazy reconnect: automatically retries upstream on next tool call
+
+### Changed
+- Stdio transport starts before upstream connection (resilient startup order)
+- Upstream connection failure is now WARNING, not FATAL
+
 ## [0.2.0] - 2026-02-25
 
 ### Changed

package/LICENSE

@@ -1,11 +1,11 @@
 GIA MCP Server — Proprietary Software License
 
-Copyright (c) 2025-2026 William J. Storey III / ACE Advising
+Copyright (c) 2025-2026 William J. Storey III / Advanced Consulting Experts (ACE)
 All Rights Reserved.
 
 NOTICE: This software and all associated documentation, algorithms,
 frameworks, and intellectual property (collectively, "the Software")
-are the proprietary property of William J. Storey III / ACE Advising.
+are the proprietary property of William J. Storey III / Advanced Consulting Experts (ACE).
 
 GRANT OF USE:
 You may install and use the Software in its compiled/distributed form
@@ -50,5 +50,5 @@ For licensing inquiries, partnership opportunities, or enterprise
 agreements, contact:
 
 William J. Storey III
-ACE Advising
+Advanced Consulting Experts (ACE)
 https://gia.aceadvising.com

package/README.md

@@ -1,11 +1,28 @@
 # GIA MCP Server
 
+[![npm version](https://img.shields.io/npm/v/gia-mcp-server)](https://www.npmjs.com/package/gia-mcp-server)
+[![License](https://img.shields.io/badge/license-proprietary-blue)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/protocol-MCP-purple)](https://modelcontextprotocol.io)
+
 **Governance Intelligence Architecture** — the governance layer for Claude AI agents.
 
 This package connects [Claude Desktop](https://claude.ai/download) and [Claude Code](https://docs.anthropic.com/en/docs/claude-code) to the hosted GIA governance engine, giving your AI workflows enterprise-grade governance: decision classification, forensic audit trails, human-in-the-loop gates, compliance mapping, and more.
 
 Built on Anthropic's [Model Context Protocol](https://modelcontextprotocol.io).
 
+## Why GIA?
+
+AI agents are powerful — but **ungoverned AI agents are a liability**. GIA solves this by providing:
+
+- **Decision Classification** — Every AI decision is classified as Mandatory (human required), Advisory (human optional), or Informational (agent autonomous)
+- **Forensic Audit Trail** — Hash-chained, tamper-evident ledger of every operation, decision, and gate approval
+- **Human-in-the-Loop Gates** — High-impact actions require explicit human approval before execution
+- **Compliance Mapping** — Map governance controls to NIST AI RMF, EU AI Act, ISO 42001, and NIST 800-53
+- **Governed Memory** — Hash-sealed knowledge packs with trust levels, TTL, and role-based access
+
+GIA is the governance layer that makes Claude deployments enterprise-ready.
+
 ## Quick Start
 
 ### 1. Get an API Key
@@ -122,4 +139,4 @@ This package is a lightweight proxy. All governance logic runs on the hosted GIA
 
 Proprietary. See [LICENSE](LICENSE) for details.
 
-Copyright (c) 2025-2026 William J. Storey III / ACE Advising
+Copyright (c) 2025-2026 William J. Storey III / Advanced Consulting Experts (ACE)

package/dist/proxy.d.ts

@@ -11,7 +11,7 @@
  * Architecture:
  *   Claude <--stdio--> this proxy <--HTTPS--> gia.aceadvising.com/mcp
  *
- * @author ACE Advising
- * @version 0.2.0
+ * @author Advanced Consulting Experts (ACE)
+ * @version 0.2.1
  */
 export {};

package/dist/proxy.js

@@ -11,15 +11,15 @@
  * Architecture:
  *   Claude <--stdio--> this proxy <--HTTPS--> gia.aceadvising.com/mcp
  *
- * @author ACE Advising
- * @version 0.2.0
+ * @author Advanced Consulting Experts (ACE)
+ * @version 0.2.1
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import { ListToolsResultSchema, CallToolResultSchema, ListResourcesResultSchema, ReadResourceResultSchema, ListResourceTemplatesResultSchema, ListPromptsResultSchema, GetPromptResultSchema, CompleteResultSchema, EmptyResultSchema, } from '@modelcontextprotocol/sdk/types.js';
-const VERSION = '0.2.0';
+const VERSION = '0.2.2';
 const DEFAULT_SERVER_URL = 'https://gia.aceadvising.com/mcp';
 // Result schema map — tells the SDK how to validate upstream responses
 const RESULT_SCHEMAS = {
@@ -37,46 +37,55 @@ const RESULT_SCHEMAS = {
 function log(msg) {
     process.stderr.write(`[GIA] ${msg}\n`);
 }
-async function main() {
-    // ── Read configuration from environment ──
-    const apiKey = process.env.GIA_API_KEY;
-    const serverUrl = process.env.GIA_SERVER_URL || DEFAULT_SERVER_URL;
-    if (!apiKey) {
-        log('ERROR: GIA_API_KEY environment variable is required.');
-        log('');
-        log('Get your API key at https://gia.aceadvising.com');
-        log('Then set it:');
-        log('  export GIA_API_KEY=gia_your_key_here');
-        log('');
-        log('Or configure it in your Claude Desktop / Claude Code settings.');
-        process.exit(1);
-    }
-    // ── Connect to upstream GIA server ──
+// Upstream connection state
+let upstream = null;
+let upstreamConnected = false;
+async function connectUpstream(apiKey, serverUrl) {
     log(`Connecting to ${serverUrl}...`);
-    const upstreamTransport = new StreamableHTTPClientTransport(new URL(serverUrl), {
+    const transport = new StreamableHTTPClientTransport(new URL(serverUrl), {
         requestInit: {
             headers: {
                 'Authorization': `Bearer ${apiKey}`,
             },
         },
     });
-    const upstream = new Client({ name: 'gia-mcp-proxy', version: VERSION }, { capabilities: {} });
+    upstream = new Client({ name: 'gia-mcp-proxy', version: VERSION }, { capabilities: {} });
     try {
-        await upstream.connect(upstreamTransport);
+        await upstream.connect(transport);
+        upstreamConnected = true;
+        log('Connected to upstream GIA server.');
+        // Handle upstream errors without crashing
+        transport.onerror = (err) => {
+            log(`Upstream error: ${err.message}`);
+        };
+        transport.onclose = () => {
+            log('Upstream connection closed. Server remains available — reconnect on next request.');
+            upstreamConnected = false;
+        };
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        log(`ERROR: Failed to connect to GIA server: ${message}`);
+        log(`WARNING: Failed to connect to GIA server: ${message}`);
+        log('Server is running in disconnected mode.');
+        log('Tool calls will return errors until upstream is reachable.');
+        upstreamConnected = false;
+    }
+}
+async function main() {
+    // ── Read configuration from environment ──
+    const apiKey = process.env.GIA_API_KEY;
+    const serverUrl = process.env.GIA_SERVER_URL || DEFAULT_SERVER_URL;
+    if (!apiKey) {
+        log('ERROR: GIA_API_KEY environment variable is required.');
+        log('');
+        log('Get your API key at https://gia.aceadvising.com');
+        log('Then set it:');
+        log('  export GIA_API_KEY=gia_your_key_here');
         log('');
-        log('Check that:');
-        log('  1. Your GIA_API_KEY is valid');
-        log(`  2. The server at ${serverUrl} is reachable`);
-        log('  3. Your network connection is active');
+        log('Or configure it in your Claude Desktop / Claude Code settings.');
         process.exit(1);
     }
-    log('Connected to upstream GIA server.');
-    // ── Create local stdio server ──
-    // Advertise capabilities that the upstream server supports
+    // ── Create local stdio server FIRST (so health checks work) ──
     const local = new Server({ name: 'gia-mcp-server', version: VERSION }, {
         capabilities: {
             tools: {},
@@ -84,7 +93,7 @@ async function main() {
             prompts: {},
         },
     });
-    // ── Bridge: forward all requests to upstream ──
+    // ── Bridge: forward requests to upstream (or return error if disconnected) ──
     local.fallbackRequestHandler = async (request) => {
         const method = request.method;
         const params = request.params ?? {};
@@ -92,12 +101,41 @@ async function main() {
         if (!schema) {
             throw new Error(`Unsupported method: ${method}`);
         }
-        // Use the Client's generic request method to forward
+        // Ping always succeeds locally — keeps the server alive for health checks
+        if (method === 'ping') {
+            return {};
+        }
+        if (!upstreamConnected || !upstream) {
+            // Try to reconnect on demand
+            await connectUpstream(apiKey, serverUrl);
+        }
+        // When disconnected, return empty results for discovery methods
+        // so health checks and tool listing still work
+        if (!upstreamConnected || !upstream) {
+            const disconnectedMsg = `[GIA disconnected] Connect to ${serverUrl} with a valid GIA_API_KEY to enable tools.`;
+            switch (method) {
+                case 'tools/list':
+                    return { tools: [{ name: 'gia_system_status', description: disconnectedMsg, inputSchema: { type: 'object', properties: {} } }] };
+                case 'resources/list':
+                    return { resources: [] };
+                case 'resources/templates/list':
+                    return { resourceTemplates: [] };
+                case 'prompts/list':
+                    return { prompts: [] };
+                case 'logging/setLevel':
+                    return {};
+                default:
+                    throw new Error('GIA upstream server is not reachable. Check your GIA_API_KEY and network connection. ' +
+                        `Server URL: ${serverUrl}`);
+            }
+        }
         const result = await upstream.request({ method, params }, schema);
         return result;
     };
     // Forward notifications from Claude to upstream
     local.fallbackNotificationHandler = async (notification) => {
+        if (!upstreamConnected || !upstream)
+            return;
         try {
             await upstream.notification({
                 method: notification.method,
@@ -115,12 +153,15 @@ async function main() {
     log(`Upstream: ${serverUrl}`);
     log('Transport: stdio <-> HTTPS');
     log('Ready.');
+    // ── Now connect upstream (non-fatal) ──
+    await connectUpstream(apiKey, serverUrl);
     // ── Graceful shutdown ──
     const shutdown = async () => {
         log('Shutting down...');
         try {
             await local.close();
-            await upstream.close();
+            if (upstream)
+                await upstream.close();
         }
         catch {
             // Best-effort cleanup
@@ -129,14 +170,6 @@ async function main() {
     };
     process.on('SIGINT', shutdown);
     process.on('SIGTERM', shutdown);
-    // ── Handle upstream errors ──
-    upstreamTransport.onerror = (err) => {
-        log(`Upstream error: ${err.message}`);
-    };
-    upstreamTransport.onclose = () => {
-        log('Upstream connection closed.');
-        process.exit(1);
-    };
 }
 main().catch((err) => {
     const message = err instanceof Error ? err.message : String(err);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "gia-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP proxy for GIA Governance — connects Claude Desktop and Claude Code to the hosted GIA governance engine.",
   "author": {
     "name": "William J. Storey III",
     "url": "https://github.com/aceadvising"
   },
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "Proprietary",
   "type": "module",
   "main": "dist/proxy.js",
   "types": "dist/proxy.d.ts",
@@ -38,6 +38,7 @@
     "url": "https://github.com/knowledgepa3/gia-mcp-server"
   },
   "homepage": "https://gia.aceadvising.com",
+  "mcpName": "io.github.knowledgepa3/gia-mcp-server",
   "engines": {
     "node": ">=18.0.0"
   },