@everstateai/mcp 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# @everstate/mcp-proxy
+
+Thin MCP proxy for Everstate. All business logic lives in the cloud.
+
+## Installation
+
+```bash
+npm install -g @everstate/mcp-proxy
+```
+
+## Configuration
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "everstate": {
+      "command": "everstate-mcp",
+      "env": {
+        "EVERSTATE_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `EVERSTATE_API_KEY` | Yes | Your Everstate API key |
+| `EVERSTATE_PROJECT_ID` | No | Default project ID for all calls |
+| `EVERSTATE_API_URL` | No | API base URL (default: `https://www.everstate.ai`) |
+| `EVERSTATE_MODE` | No | Tool mode: `core`, `meta`, or `extended` |
+
+## How It Works
+
+This proxy is intentionally minimal (~50 lines). It:
+
+1. Fetches tool definitions from the Everstate API
+2. Forwards tool calls to the Everstate API
+3. Returns responses to Claude
+
+All business logic, tool schemas, and data operations live server-side. You get:
+- Instant updates (no npm updates needed)
+- Feature gating by API key tier
+- Full security and metering server-side
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Everstate MCP Proxy
+ *
+ * A thin proxy that forwards MCP calls to the Everstate cloud API.
+ * All business logic, tool definitions, and data operations live server-side.
+ *
+ * This file is intentionally minimal (~50 lines of actual logic).
+ * Users see nothing proprietary - just HTTP forwarding.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/index.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Everstate MCP Proxy
+ *
+ * A thin proxy that forwards MCP calls to the Everstate cloud API.
+ * All business logic, tool definitions, and data operations live server-side.
+ *
+ * This file is intentionally minimal (~50 lines of actual logic).
+ * Users see nothing proprietary - just HTTP forwarding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const API_BASE = process.env.EVERSTATE_API_URL || "https://www.everstate.ai";
+const API_KEY = process.env.EVERSTATE_API_KEY;
+const PROJECT_ID = process.env.EVERSTATE_PROJECT_ID;
+if (!API_KEY) {
+    console.error("EVERSTATE_API_KEY environment variable is required");
+    process.exit(1);
+}
+// Create MCP server
+const server = new index_js_1.Server({ name: "everstate", version: "1.0.0" }, { capabilities: { tools: {} } });
+// Fetch tool definitions from cloud
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    const res = await fetch(`${API_BASE}/mcp/tools`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ mode: process.env.EVERSTATE_MODE }),
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch tools: ${res.status} ${res.statusText}`);
+    }
+    const data = (await res.json());
+    return { tools: data.tools };
+});
+// Forward tool calls to cloud
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    // Inject default projectId if not provided and we have one configured
+    // For meta-tool (everstate), projectId may be in params.projectId
+    const enrichedArgs = { ...args };
+    const params = enrichedArgs.params;
+    const hasProjectIdInParams = params && typeof params === 'object' && 'projectId' in params && params.projectId;
+    if (PROJECT_ID && !enrichedArgs.projectId && !hasProjectIdInParams) {
+        enrichedArgs.projectId = PROJECT_ID;
+    }
+    const res = await fetch(`${API_BASE}/mcp/execute`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ name, arguments: enrichedArgs }),
+    });
+    if (!res.ok) {
+        return {
+            content: [{ type: "text", text: `API error: ${res.status} ${res.statusText}` }],
+            isError: true,
+        };
+    }
+    return (await res.json());
+});
+// Start server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Everstate MCP Proxy connected to", API_BASE);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AACA;;;;;;;;GAQG;;AAEH,wEAAmE;AACnE,wEAAiF;AACjF,iEAM4C;AAE5C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,0BAA0B,CAAC;AAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;AAEpD,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAQD,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EACvC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAA8B,EAAE;IACpF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,YAAY,EAAE;QAC/C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,OAAO,EAAE;YAClC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;KAC3D,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAkB,CAAC;IACjD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEH,8BAA8B;AAC9B,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAA2B,EAAE;IACzF,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,sEAAsE;IACtE,kEAAkE;IAClE,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,EAA6B,CAAC;IAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,MAA6C,CAAC;IAC1E,MAAM,oBAAoB,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,WAAW,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC;IAC/G,IAAI,UAAU,IAAI,CAAC,YAAY,CAAC,SAAS,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACnE,YAAY,CAAC,SAAS,GAAG,UAAU,CAAC;IACtC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,cAAc,EAAE;QACjD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,OAAO,EAAE;YAClC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;KACxD,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;YAC/E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@everstateai/mcp",
+  "version": "1.0.0",
+  "description": "Everstate MCP server - persistent AI coding memory",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "everstate-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "everstate",
+    "claude",
+    "ai",
+    "memory",
+    "context"
+  ],
+  "author": "Everstate.ai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rshambaugh/everstate"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Everstate MCP Proxy
+ *
+ * A thin proxy that forwards MCP calls to the Everstate cloud API.
+ * All business logic, tool definitions, and data operations live server-side.
+ *
+ * This file is intentionally minimal (~50 lines of actual logic).
+ * Users see nothing proprietary - just HTTP forwarding.
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  CallToolResult,
+  ListToolsResult,
+  Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const API_BASE = process.env.EVERSTATE_API_URL || "https://www.everstate.ai";
+const API_KEY = process.env.EVERSTATE_API_KEY;
+const PROJECT_ID = process.env.EVERSTATE_PROJECT_ID;
+
+if (!API_KEY) {
+  console.error("EVERSTATE_API_KEY environment variable is required");
+  process.exit(1);
+}
+
+// Type for API responses
+interface ToolsResponse {
+  tools: Tool[];
+  meta?: { tier: string; mode: string; totalTools: number };
+}
+
+// Create MCP server
+const server = new Server(
+  { name: "everstate", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+// Fetch tool definitions from cloud
+server.setRequestHandler(ListToolsRequestSchema, async (): Promise<ListToolsResult> => {
+  const res = await fetch(`${API_BASE}/mcp/tools`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ mode: process.env.EVERSTATE_MODE }),
+  });
+
+  if (!res.ok) {
+    throw new Error(`Failed to fetch tools: ${res.status} ${res.statusText}`);
+  }
+
+  const data = (await res.json()) as ToolsResponse;
+  return { tools: data.tools };
+});
+
+// Forward tool calls to cloud
+server.setRequestHandler(CallToolRequestSchema, async (request): Promise<CallToolResult> => {
+  const { name, arguments: args } = request.params;
+
+  // Inject default projectId if not provided and we have one configured
+  // For meta-tool (everstate), projectId may be in params.projectId
+  const enrichedArgs = { ...args } as Record<string, unknown>;
+  const params = enrichedArgs.params as Record<string, unknown> | undefined;
+  const hasProjectIdInParams = params && typeof params === 'object' && 'projectId' in params && params.projectId;
+  if (PROJECT_ID && !enrichedArgs.projectId && !hasProjectIdInParams) {
+    enrichedArgs.projectId = PROJECT_ID;
+  }
+
+  const res = await fetch(`${API_BASE}/mcp/execute`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ name, arguments: enrichedArgs }),
+  });
+
+  if (!res.ok) {
+    return {
+      content: [{ type: "text", text: `API error: ${res.status} ${res.statusText}` }],
+      isError: true,
+    };
+  }
+
+  return (await res.json()) as CallToolResult;
+});
+
+// Start server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Everstate MCP Proxy connected to", API_BASE);
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/tsconfig.json

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