@almanak/mcp-server 0.1.0

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MCP stdio transport server.
+ * JSON-RPC 2.0 over stdin/stdout with newline-delimited JSON (MCP SDK convention).
+ */
+import { Readable, Writable } from 'stream';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface ToolCallResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export interface McpServerHandler {
+    listTools(): ToolDefinition[];
+    callTool(name: string, args: Record<string, unknown>): Promise<ToolCallResult>;
+}
+export declare class McpStdioServer {
+    private reader;
+    private writer;
+    private handler;
+    private lineBuf;
+    constructor(handler: McpServerHandler, reader?: Readable, writer?: Writable);
+    run(): Promise<void>;
+    private processLines;
+    private handleRawMessage;
+    private dispatch;
+    private sendResult;
+    private sendError;
+    private writeMessage;
+}

package/dist/server.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * MCP stdio transport server.
+ * JSON-RPC 2.0 over stdin/stdout with newline-delimited JSON (MCP SDK convention).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpStdioServer = void 0;
+const MCP_PROTOCOL_VERSION = '2024-11-05';
+const SERVER_NAME = 'almanak-platform';
+const SERVER_VERSION = '1.0.0';
+const ErrorCode = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INTERNAL_ERROR: -32603,
+};
+class McpStdioServer {
+    constructor(handler, reader, writer) {
+        this.lineBuf = '';
+        this.handler = handler;
+        this.reader = reader !== null && reader !== void 0 ? reader : process.stdin;
+        this.writer = writer !== null && writer !== void 0 ? writer : process.stdout;
+    }
+    async run() {
+        return new Promise((resolve) => {
+            this.reader.setEncoding('utf-8');
+            this.reader.on('data', (chunk) => {
+                this.lineBuf += chunk;
+                this.processLines();
+            });
+            this.reader.on('end', () => resolve());
+            this.reader.on('close', () => resolve());
+        });
+    }
+    processLines() {
+        while (true) {
+            const newlineIdx = this.lineBuf.indexOf('\n');
+            if (newlineIdx === -1)
+                break;
+            const line = this.lineBuf.slice(0, newlineIdx).replace(/\r$/, '');
+            this.lineBuf = this.lineBuf.slice(newlineIdx + 1);
+            if (line.length === 0)
+                continue;
+            this.handleRawMessage(line);
+        }
+    }
+    async handleRawMessage(body) {
+        var _a, _b;
+        let message;
+        try {
+            message = JSON.parse(body);
+        }
+        catch {
+            this.sendError(null, ErrorCode.PARSE_ERROR, 'Invalid JSON');
+            return;
+        }
+        if (typeof message !== 'object' || message === null) {
+            this.sendError(null, ErrorCode.INVALID_REQUEST, 'Message must be an object');
+            return;
+        }
+        const { id, method } = message;
+        if (message.jsonrpc !== '2.0') {
+            if (id !== undefined) {
+                this.sendError(id, ErrorCode.INVALID_REQUEST, 'Invalid or missing jsonrpc version');
+            }
+            return;
+        }
+        if (!method || typeof method !== 'string') {
+            if (id !== undefined) {
+                this.sendError(id, ErrorCode.INVALID_REQUEST, 'Missing method');
+            }
+            return;
+        }
+        try {
+            const result = await this.dispatch(method, (_a = message.params) !== null && _a !== void 0 ? _a : {});
+            if (id !== undefined) {
+                this.sendResult(id, result);
+            }
+        }
+        catch (err) {
+            if (id !== undefined) {
+                const code = typeof (err === null || err === void 0 ? void 0 : err.code) === 'number' ? err.code : ErrorCode.INTERNAL_ERROR;
+                this.sendError(id, code, (_b = err.message) !== null && _b !== void 0 ? _b : 'Internal error');
+            }
+        }
+    }
+    async dispatch(method, params) {
+        var _a;
+        switch (method) {
+            case 'initialize':
+                return {
+                    protocolVersion: MCP_PROTOCOL_VERSION,
+                    capabilities: {
+                        tools: { listChanged: false },
+                    },
+                    serverInfo: {
+                        name: SERVER_NAME,
+                        version: SERVER_VERSION,
+                    },
+                };
+            case 'initialized':
+            case 'notifications/initialized':
+            case 'notifications/cancelled':
+                return undefined;
+            case 'ping':
+                return {};
+            case 'tools/list':
+                return { tools: this.handler.listTools() };
+            case 'tools/call': {
+                const name = params === null || params === void 0 ? void 0 : params.name;
+                const args = (_a = params === null || params === void 0 ? void 0 : params.arguments) !== null && _a !== void 0 ? _a : {};
+                if (!name || typeof name !== 'string') {
+                    throw Object.assign(new Error('tools/call requires a string "name" parameter'), {
+                        code: ErrorCode.INVALID_REQUEST,
+                    });
+                }
+                if (typeof args !== 'object' || args === null || Array.isArray(args)) {
+                    throw Object.assign(new Error('tools/call "arguments" must be an object'), {
+                        code: ErrorCode.INVALID_REQUEST,
+                    });
+                }
+                return this.handler.callTool(name, args);
+            }
+            default:
+                throw Object.assign(new Error(`Unknown method: ${method}`), {
+                    code: ErrorCode.METHOD_NOT_FOUND,
+                });
+        }
+    }
+    sendResult(id, result) {
+        this.writeMessage({
+            jsonrpc: '2.0',
+            id,
+            result: result !== null && result !== void 0 ? result : {},
+        });
+    }
+    sendError(id, code, message) {
+        this.writeMessage({
+            jsonrpc: '2.0',
+            id: id !== null && id !== void 0 ? id : null,
+            error: { code, message },
+        });
+    }
+    writeMessage(msg) {
+        this.writer.write(JSON.stringify(msg) + '\n');
+    }
+}
+exports.McpStdioServer = McpStdioServer;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tool catalog and dispatch for the Almanak MCP server.
+ *
+ * Tools are organized into modes that can be selectively enabled:
+ *   agents     - Agent lifecycle (deploy, state, pause, stop, logs, pnl, etc.)
+ *   wallets    - Wallet listing, positions, role verification
+ *   strategies - Strategy linking, validation, metadata
+ *   github     - Repository browsing (branches, tags, commits)
+ *   edge       - Edge signals and opportunities (planned)
+ *   all        - All available tools
+ */
+import { PlatformClient } from './client';
+import { ToolDefinition, ToolCallResult, McpServerHandler } from './server';
+export type ToolMode = 'agents' | 'wallets' | 'strategies' | 'github' | 'edge' | 'all';
+export interface ToolHandlerOptions {
+    includeSecretTools?: boolean;
+    modes?: ToolMode[];
+}
+export declare class PlatformToolHandler implements McpServerHandler {
+    private client;
+    private tools;
+    private options;
+    private enabledModes;
+    constructor(client: PlatformClient, options?: ToolHandlerOptions);
+    listTools(): ToolDefinition[];
+    callTool(name: string, args: Record<string, unknown>): Promise<ToolCallResult>;
+    private modeEnabled;
+    private register;
+    private registerSecret;
+    private registerAll;
+}