@gopherhole/mcp 0.1.0

package/README.md

@@ -0,0 +1,183 @@
+# @gopherhole/mcp
+
+MCP (Model Context Protocol) server for [GopherHole](https://gopherhole.ai) — access AI agents from Claude Code, Cursor, Windsurf, and other MCP-compatible IDEs.
+
+## What This Does
+
+When installed, you can use GopherHole agents directly from your IDE:
+
+```
+You in Cursor: "Remember that the API uses OAuth 2.0"
+                      ↓
+                MCP Server
+                      ↓
+          GopherHole → @memory agent
+                      ↓
+              "Remembered!"
+```
+
+## Quick Start
+
+### 1. Get a GopherHole API Key
+
+Sign up at [gopherhole.ai](https://gopherhole.ai) and create an API key.
+
+### 2. Configure Your IDE
+
+#### Claude Code / Claude Desktop
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gopherhole": {
+      "command": "npx",
+      "args": ["@gopherhole/mcp"],
+      "env": {
+        "GOPHERHOLE_API_KEY": "gph_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+#### Cursor
+
+Add to your Cursor settings (`~/.cursor/mcp.json` or via Settings > MCP):
+
+```json
+{
+  "mcpServers": {
+    "gopherhole": {
+      "command": "npx",
+      "args": ["@gopherhole/mcp"],
+      "env": {
+        "GOPHERHOLE_API_KEY": "gph_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+#### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gopherhole": {
+      "command": "npx",
+      "args": ["@gopherhole/mcp"],
+      "env": {
+        "GOPHERHOLE_API_KEY": "gph_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Your IDE
+
+Restart your IDE to pick up the new MCP server configuration.
+
+## Available Tools
+
+### `memory_store`
+Store a memory for later recall.
+
+```
+"Remember that the API rate limit is 100 requests per minute"
+"Remember that John prefers dark mode"
+```
+
+**Parameters:**
+- `content` (required): What to remember
+- `tags` (optional): Array of tags to categorize the memory
+
+### `memory_recall`
+Recall memories about a topic.
+
+```
+"What do I know about the API?"
+"Recall memories about John's preferences"
+```
+
+**Parameters:**
+- `query` (required): What to search for
+- `limit` (optional): Maximum number of memories to return
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GOPHERHOLE_API_KEY` | Yes | Your GopherHole API key (starts with `gph_`) |
+| `GOPHERHOLE_API_URL` | No | Custom API URL (default: `https://gopherhole.ai`) |
+| `GOPHERHOLE_MEMORY_AGENT` | No | Custom memory agent ID (default: `memory`) |
+
+## Local Development
+
+```bash
+# Clone and install
+git clone https://github.com/gopherhole/mcp.git
+cd mcp
+npm install
+
+# Build
+npm run build
+
+# Test tools/list
+echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | GOPHERHOLE_API_KEY=gph_xxx node dist/index.js
+
+# Test memory_store
+echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"memory_store","arguments":{"content":"test memory"}},"id":2}' | GOPHERHOLE_API_KEY=gph_xxx node dist/index.js
+```
+
+## How It Works
+
+This MCP server translates MCP tool calls into GopherHole A2A (Agent-to-Agent) messages:
+
+1. IDE calls MCP tool (e.g., `memory_store`)
+2. MCP server sends A2A message to GopherHole
+3. GopherHole routes to the appropriate agent (e.g., `@memory`)
+4. Agent processes and responds
+5. MCP server returns the result to the IDE
+
+## Roadmap
+
+### Phase 1 (Current)
+- ✅ `memory_store` — Store memories
+- ✅ `memory_recall` — Recall memories
+
+### Phase 2 (Coming Soon)
+- `memory_forget` — Delete memories
+- `memory_list` — List recent memories
+- `agent_discover` — Find agents on GopherHole
+- `agent_message` — Message any GopherHole agent
+
+## Troubleshooting
+
+### "GOPHERHOLE_API_KEY environment variable is required"
+
+Make sure you've set the API key in your MCP server configuration.
+
+### "Task failed" or timeout errors
+
+Check that your API key is valid and has access to the memory agent.
+
+### Server not appearing in IDE
+
+1. Check your config file path is correct
+2. Restart your IDE
+3. Check IDE logs for MCP errors
+
+## Links
+
+- [GopherHole](https://gopherhole.ai) - AI Agent Hub
+- [MCP Protocol](https://modelcontextprotocol.io) - Model Context Protocol docs
+- [GopherHole SDK](https://www.npmjs.com/package/@gopherhole/sdk) - TypeScript SDK
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,94 @@
+/**
+ * GopherHole API Client
+ * Lightweight HTTP client for the MCP server
+ */
+export interface GopherHoleConfig {
+    apiKey: string;
+    apiUrl?: string;
+    timeout?: number;
+}
+export interface Task {
+    id: string;
+    contextId: string;
+    status: {
+        state: 'submitted' | 'working' | 'completed' | 'failed' | 'canceled' | 'rejected';
+        message?: string;
+        timestamp?: string;
+    };
+    history?: Array<{
+        role: 'user' | 'agent';
+        parts: Array<{
+            kind: 'text' | 'file' | 'data';
+            text?: string;
+        }>;
+    }>;
+    artifacts?: Array<{
+        name?: string;
+        parts?: Array<{
+            kind: 'text' | 'file' | 'data';
+            text?: string;
+        }>;
+    }>;
+}
+export interface DiscoverResult {
+    agents: Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        category: string | null;
+        tags: string[];
+        pricing: 'free' | 'paid' | 'contact';
+        avgRating: number;
+        ratingCount: number;
+        tenantName: string;
+    }>;
+    count: number;
+}
+export declare class GopherHoleClient {
+    private apiKey;
+    private apiUrl;
+    private timeout;
+    constructor(config: GopherHoleConfig);
+    /**
+     * Make an A2A JSON-RPC call
+     */
+    private rpc;
+    /**
+     * Send a text message to an agent
+     */
+    sendText(agentId: string, text: string, contextId?: string): Promise<Task>;
+    /**
+     * Get a task by ID
+     */
+    getTask(taskId: string): Promise<Task>;
+    /**
+     * Wait for a task to complete (polling)
+     */
+    waitForTask(taskId: string, maxWaitMs?: number, pollIntervalMs?: number): Promise<Task>;
+    /**
+     * Send text and wait for completion
+     */
+    sendTextAndWait(agentId: string, text: string, contextId?: string): Promise<Task>;
+    /**
+     * Send text and get the response text
+     */
+    askText(agentId: string, text: string): Promise<string>;
+    /**
+     * Extract text response from a completed task
+     */
+    private extractResponseText;
+    /**
+     * Discover agents
+     */
+    discover(options?: {
+        query?: string;
+        category?: string;
+        tag?: string;
+        limit?: number;
+    }): Promise<DiscoverResult>;
+    /**
+     * Create client from environment
+     */
+    static fromEnv(): GopherHoleClient;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;QAClF,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACvB,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjE,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACrC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,gBAAgB;IAMpC;;OAEG;YACW,GAAG;IAqCjB;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahF;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAQ,EAAE,cAAc,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1F;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvF;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU7D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqC3B;;OAEG;IACG,QAAQ,CAAC,OAAO,CAAC,EAAE;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,cAAc,CAAC;IAoB3B;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,gBAAgB;CAWnC"}

package/dist/client.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * GopherHole API Client
+ * Lightweight HTTP client for the MCP server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GopherHoleClient = void 0;
+const DEFAULT_API_URL = 'https://gopherhole.ai';
+class GopherHoleClient {
+    apiKey;
+    apiUrl;
+    timeout;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.apiUrl = config.apiUrl || DEFAULT_API_URL;
+        this.timeout = config.timeout || 60000;
+    }
+    /**
+     * Make an A2A JSON-RPC call
+     */
+    async rpc(method, params) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.apiUrl}/a2a`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    method,
+                    params,
+                    id: Date.now(),
+                }),
+                signal: controller.signal,
+            });
+            const data = await response.json();
+            if (data.error) {
+                throw new Error(data.error.message || 'RPC error');
+            }
+            return data.result;
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError') {
+                throw new Error(`Request timeout after ${this.timeout}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Send a text message to an agent
+     */
+    async sendText(agentId, text, contextId) {
+        return this.rpc('message/send', {
+            message: {
+                role: 'user',
+                parts: [{ kind: 'text', text }],
+            },
+            configuration: {
+                agentId,
+                contextId,
+            },
+        });
+    }
+    /**
+     * Get a task by ID
+     */
+    async getTask(taskId) {
+        return this.rpc('tasks/get', { id: taskId });
+    }
+    /**
+     * Wait for a task to complete (polling)
+     */
+    async waitForTask(taskId, maxWaitMs = 60000, pollIntervalMs = 1000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < maxWaitMs) {
+            const task = await this.getTask(taskId);
+            if (['completed', 'failed', 'canceled', 'rejected'].includes(task.status.state)) {
+                return task;
+            }
+            await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+        }
+        throw new Error(`Task ${taskId} did not complete within ${maxWaitMs}ms`);
+    }
+    /**
+     * Send text and wait for completion
+     */
+    async sendTextAndWait(agentId, text, contextId) {
+        const task = await this.sendText(agentId, text, contextId);
+        return this.waitForTask(task.id);
+    }
+    /**
+     * Send text and get the response text
+     */
+    async askText(agentId, text) {
+        const task = await this.sendTextAndWait(agentId, text);
+        if (task.status.state === 'failed') {
+            throw new Error(task.status.message || 'Task failed');
+        }
+        return this.extractResponseText(task);
+    }
+    /**
+     * Extract text response from a completed task
+     */
+    extractResponseText(task) {
+        // Check artifacts first
+        if (task.artifacts?.length) {
+            const texts = [];
+            for (const artifact of task.artifacts) {
+                if (artifact.parts) {
+                    for (const part of artifact.parts) {
+                        if (part.kind === 'text' && part.text) {
+                            texts.push(part.text);
+                        }
+                    }
+                }
+            }
+            if (texts.length > 0) {
+                return texts.join('\n');
+            }
+        }
+        // Fall back to history
+        if (task.history?.length) {
+            const lastMessage = task.history[task.history.length - 1];
+            if (lastMessage.parts) {
+                const texts = [];
+                for (const part of lastMessage.parts) {
+                    if (part.kind === 'text' && part.text) {
+                        texts.push(part.text);
+                    }
+                }
+                if (texts.length > 0) {
+                    return texts.join('\n');
+                }
+            }
+        }
+        return '';
+    }
+    /**
+     * Discover agents
+     */
+    async discover(options) {
+        const params = new URLSearchParams();
+        if (options?.query)
+            params.set('q', options.query);
+        if (options?.category)
+            params.set('category', options.category);
+        if (options?.tag)
+            params.set('tag', options.tag);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const response = await fetch(`${this.apiUrl}/api/discover/agents?${params}`, {
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Discovery failed: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Create client from environment
+     */
+    static fromEnv() {
+        const apiKey = process.env.GOPHERHOLE_API_KEY;
+        if (!apiKey) {
+            throw new Error('GOPHERHOLE_API_KEY environment variable is required');
+        }
+        return new GopherHoleClient({
+            apiKey,
+            apiUrl: process.env.GOPHERHOLE_API_URL,
+        });
+    }
+}
+exports.GopherHoleClient = GopherHoleClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * GopherHole MCP Server
+ *
+ * Exposes GopherHole agents as MCP tools for Claude Code, Cursor, and other
+ * MCP-compatible IDEs.
+ */
+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;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * GopherHole MCP Server
+ *
+ * Exposes GopherHole agents as MCP tools for Claude Code, Cursor, and other
+ * MCP-compatible IDEs.
+ */
+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 client_js_1 = require("./client.js");
+const tools_js_1 = require("./tools.js");
+// Default memory agent ID (can be overridden via env)
+const MEMORY_AGENT_ID = process.env.GOPHERHOLE_MEMORY_AGENT || 'memory';
+/**
+ * Format tags for the memory store message
+ */
+function formatStoreMessage(content, tags) {
+    let message = `Remember this:\n\n${content}`;
+    if (tags?.length) {
+        message += `\n\nTags: ${tags.join(', ')}`;
+    }
+    return message;
+}
+/**
+ * Format search query for memory recall
+ */
+function formatRecallMessage(query, limit) {
+    let message = `Search memories for: ${query}`;
+    if (limit) {
+        message += ` (limit: ${limit})`;
+    }
+    return message;
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    // Initialize GopherHole client
+    let client;
+    try {
+        client = client_js_1.GopherHoleClient.fromEnv();
+    }
+    catch (error) {
+        console.error('Error: GOPHERHOLE_API_KEY environment variable is required');
+        console.error('Get your API key at https://gopherhole.ai');
+        process.exit(1);
+    }
+    // Create MCP server
+    const server = new index_js_1.Server({
+        name: 'gopherhole',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Handle tools/list
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+        return { tools: tools_js_1.ALL_TOOLS };
+    });
+    // Handle tools/call
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            switch (name) {
+                case 'memory_store': {
+                    const content = args?.content;
+                    const tags = args?.tags;
+                    if (!content) {
+                        return {
+                            content: [{ type: 'text', text: 'Error: content is required' }],
+                            isError: true,
+                        };
+                    }
+                    const message = formatStoreMessage(content, tags);
+                    const response = await client.askText(MEMORY_AGENT_ID, message);
+                    return {
+                        content: [{ type: 'text', text: response || 'Memory stored successfully' }],
+                    };
+                }
+                case 'memory_recall': {
+                    const query = args?.query;
+                    const limit = args?.limit;
+                    if (!query) {
+                        return {
+                            content: [{ type: 'text', text: 'Error: query is required' }],
+                            isError: true,
+                        };
+                    }
+                    const message = formatRecallMessage(query, limit);
+                    const response = await client.askText(MEMORY_AGENT_ID, message);
+                    return {
+                        content: [{ type: 'text', text: response || 'No memories found' }],
+                    };
+                }
+                case 'memory_forget': {
+                    const query = args?.query;
+                    const confirmDelete = args?.confirmDelete;
+                    if (!query || !confirmDelete) {
+                        return {
+                            content: [{ type: 'text', text: 'Error: query and confirmDelete=true are required' }],
+                            isError: true,
+                        };
+                    }
+                    const response = await client.askText(MEMORY_AGENT_ID, `Forget memories matching: ${query}`);
+                    return {
+                        content: [{ type: 'text', text: response || 'Memories deleted' }],
+                    };
+                }
+                case 'memory_list': {
+                    const limit = args?.limit || 20;
+                    const offset = args?.offset || 0;
+                    const response = await client.askText(MEMORY_AGENT_ID, `List my recent memories (limit: ${limit}, offset: ${offset})`);
+                    return {
+                        content: [{ type: 'text', text: response || 'No memories found' }],
+                    };
+                }
+                case 'agent_discover': {
+                    const query = args?.query;
+                    const category = args?.category;
+                    const limit = args?.limit;
+                    const result = await client.discover({ query, category, limit });
+                    if (result.agents.length === 0) {
+                        return {
+                            content: [{ type: 'text', text: 'No agents found matching your criteria' }],
+                        };
+                    }
+                    const agentList = result.agents.map(a => `• **${a.name}** (${a.id})\n  ${a.description || 'No description'}\n  Rating: ${a.avgRating.toFixed(1)} ⭐ (${a.ratingCount} reviews)`).join('\n\n');
+                    return {
+                        content: [{ type: 'text', text: `Found ${result.count} agents:\n\n${agentList}` }],
+                    };
+                }
+                case 'agent_message': {
+                    const agentId = args?.agentId;
+                    const message = args?.message;
+                    if (!agentId || !message) {
+                        return {
+                            content: [{ type: 'text', text: 'Error: agentId and message are required' }],
+                            isError: true,
+                        };
+                    }
+                    const response = await client.askText(agentId, message);
+                    return {
+                        content: [{ type: 'text', text: response || 'No response from agent' }],
+                    };
+                }
+                default:
+                    return {
+                        content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Error: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
+    // Start server with stdio transport
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is for MCP protocol)
+    console.error('GopherHole MCP server started');
+}
+// Run
+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":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP Tool Definitions for GopherHole
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Phase 1 Tools - Memory
+ */
+export declare const MEMORY_TOOLS: Tool[];
+/**
+ * Phase 2 Tools - Extended Memory
+ */
+export declare const EXTENDED_MEMORY_TOOLS: Tool[];
+/**
+ * Phase 2 Tools - Agent Discovery & Messaging
+ */
+export declare const AGENT_TOOLS: Tool[];
+/**
+ * All tools combined
+ */
+export declare const ALL_TOOLS: Tool[];
+/**
+ * Get tool by name
+ */
+export declare function getTool(name: string): Tool | undefined;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,IAAI,EAsC9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,IAAI,EAoCvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,IAAI,EAwC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,IAAI,EAK3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEtD"}

package/dist/tools.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * MCP Tool Definitions for GopherHole
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_TOOLS = exports.AGENT_TOOLS = exports.EXTENDED_MEMORY_TOOLS = exports.MEMORY_TOOLS = void 0;
+exports.getTool = getTool;
+/**
+ * Phase 1 Tools - Memory
+ */
+exports.MEMORY_TOOLS = [
+    {
+        name: 'memory_store',
+        description: 'Store a memory for later recall. Use this to remember important information, decisions, preferences, or context that should persist across conversations.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'What to remember. Be specific and include relevant context.',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional tags to categorize the memory (e.g., "project", "preference", "decision")',
+                },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'memory_recall',
+        description: 'Recall memories about a topic. Search through stored memories to find relevant information.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'What to search for. Can be a topic, keyword, or question.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of memories to return (default: 10)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+];
+/**
+ * Phase 2 Tools - Extended Memory
+ */
+exports.EXTENDED_MEMORY_TOOLS = [
+    {
+        name: 'memory_forget',
+        description: 'Forget/delete memories matching a query. Use carefully - this permanently removes memories.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Query to match memories to forget',
+                },
+                confirmDelete: {
+                    type: 'boolean',
+                    description: 'Must be true to confirm deletion',
+                },
+            },
+            required: ['query', 'confirmDelete'],
+        },
+    },
+    {
+        name: 'memory_list',
+        description: 'List recent memories without searching. Good for reviewing what has been stored.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of memories to return (default: 20)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Pagination offset',
+                },
+            },
+        },
+    },
+];
+/**
+ * Phase 2 Tools - Agent Discovery & Messaging
+ */
+exports.AGENT_TOOLS = [
+    {
+        name: 'agent_discover',
+        description: 'Find agents on GopherHole by capability, category, or search query.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query to find agents',
+                },
+                category: {
+                    type: 'string',
+                    description: 'Filter by category (e.g., "memory", "search", "code")',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of agents to return (default: 10)',
+                },
+            },
+        },
+    },
+    {
+        name: 'agent_message',
+        description: 'Send a message to any GopherHole agent and get a response.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: {
+                    type: 'string',
+                    description: 'The agent ID (e.g., "memory", "search", or a full agent ID)',
+                },
+                message: {
+                    type: 'string',
+                    description: 'Message to send to the agent',
+                },
+            },
+            required: ['agentId', 'message'],
+        },
+    },
+];
+/**
+ * All tools combined
+ */
+exports.ALL_TOOLS = [
+    ...exports.MEMORY_TOOLS,
+    // Phase 2: Uncomment when ready
+    // ...EXTENDED_MEMORY_TOOLS,
+    // ...AGENT_TOOLS,
+];
+/**
+ * Get tool by name
+ */
+function getTool(name) {
+    return exports.ALL_TOOLS.find(t => t.name === name);
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@gopherhole/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for GopherHole - Access AI agents from Claude Code, Cursor, and other MCP-compatible IDEs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "gopherhole-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "echo '{\"jsonrpc\":\"2.0\",\"method\":\"tools/list\",\"id\":1}' | node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "gopherhole",
+    "ai",
+    "agents",
+    "a2a",
+    "claude",
+    "cursor",
+    "model-context-protocol"
+  ],
+  "author": "GopherHole",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gopherhole/mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}