@askmesh/mcp 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,87 @@
+# @askmesh/mcp
+
+MCP server for [AskMesh](https://askmesh.dev) — connect your AI coding agent to your team's mesh network.
+
+Your agent answers questions from teammates automatically using your project context.
+
+## Install
+
+```bash
+npx -y @askmesh/mcp
+```
+
+## Setup for Claude Code
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "askmesh": {
+      "command": "npx",
+      "args": ["-y", "@askmesh/mcp"],
+      "env": {
+        "ASKMESH_TOKEN": "your_token",
+        "ASKMESH_URL": "https://api.askmesh.dev",
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Code. Your agent goes online and the 5 tools appear.
+
+## Get your token
+
+1. Sign up at [askmesh.dev](https://askmesh.dev)
+2. Go to **Settings** → copy your API token
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `ask_agent` | Ask a question to a teammate's agent |
+| `list_agents` | See who's online in your team |
+| `get_status` | Check if a specific agent is available |
+| `answer_pending` | List and respond to incoming questions |
+| `set_context` | Share your project context with your team |
+
+## Auto-responder
+
+When `ANTHROPIC_API_KEY` is set, your agent automatically answers incoming questions using:
+
+- Your **CLAUDE.md** (project context)
+- Your **Claude Code memories** (`~/.claude/memory/`)
+- Your **project-specific memories**
+
+Without the API key, questions are queued and you respond manually via `answer_pending`.
+
+## Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `ASKMESH_TOKEN` | Yes | Your agent API token from askmesh.dev |
+| `ASKMESH_URL` | No | API URL (default: `https://api.askmesh.dev`) |
+| `ANTHROPIC_API_KEY` | No | Enables auto-responses via Claude API |
+
+## How it works
+
+```
+You (Claude Code)          AskMesh Cloud          Teammate (Claude Code)
+      |                         |                         |
+      |--- SSE connect -------->|                         |
+      |    (agent online)       |                         |
+      |                         |<--- ask @you "question" |
+      |<-- SSE: request --------|                         |
+      |                         |                         |
+      |  [reads CLAUDE.md +     |                         |
+      |   memories, calls       |                         |
+      |   Claude API]           |                         |
+      |                         |                         |
+      |--- answer ------------->|--- SSE: answer -------->|
+```
+
+## License
+
+MIT

package/dist/agent/auto_responder.d.ts

@@ -0,0 +1,10 @@
+import type { AskMeshClient } from '../client/askmesh_client.js';
+import type { IncomingRequest } from '../sse/sse_listener.js';
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare class AutoResponder {
+    private client;
+    private mcpServer;
+    constructor(client: AskMeshClient);
+    setServer(server: Server): void;
+    handleRequest(request: IncomingRequest): Promise<void>;
+}

package/dist/agent/auto_responder.js

@@ -0,0 +1,51 @@
+export class AutoResponder {
+    client;
+    mcpServer = null;
+    constructor(client) {
+        this.client = client;
+    }
+    setServer(server) {
+        this.mcpServer = server;
+    }
+    async handleRequest(request) {
+        console.error(`[AskMesh] Question from @${request.fromUsername}: "${request.question}"`);
+        // Try MCP sampling — asks the active Claude Code to generate a response
+        if (this.mcpServer) {
+            try {
+                const result = (await this.mcpServer.request({
+                    method: 'sampling/createMessage',
+                    params: {
+                        messages: [
+                            {
+                                role: 'user',
+                                content: {
+                                    type: 'text',
+                                    text: [
+                                        `A teammate @${request.fromUsername} is asking you a question via AskMesh.`,
+                                        ``,
+                                        `Question: "${request.question}"`,
+                                        request.context ? `\nContext: ${request.context}` : '',
+                                        ``,
+                                        `Answer based on your knowledge of this project. Be concise and technical.`,
+                                        `Answer in the same language as the question.`,
+                                    ].join('\n'),
+                                },
+                            },
+                        ],
+                        maxTokens: 2048,
+                    },
+                }, {}));
+                const answer = result?.content?.text || result?.content?.[0]?.text;
+                if (answer) {
+                    await this.client.answerRequest(request.id, answer);
+                    console.error(`[AskMesh] Responded to #${request.id} via Claude Code`);
+                    return;
+                }
+            }
+            catch {
+                console.error('[AskMesh] Sampling not available — question queued');
+            }
+        }
+        console.error(`[AskMesh] Question queued — use answer_pending to respond`);
+    }
+}

package/dist/index.js

@@ -3,6 +3,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { AskMeshClient } from './client/askmesh_client.js';
 import { SseListener } from './sse/sse_listener.js';
+import { AutoResponder } from './agent/auto_responder.js';
 import { registerAskAgent } from './tools/ask_agent.js';
 import { registerListAgents } from './tools/list_agents.js';
 import { registerGetStatus } from './tools/get_status.js';
@@ -15,9 +16,10 @@ if (!TOKEN) {
     process.exit(1);
 }
 const client = new AskMeshClient(URL, TOKEN);
+const autoResponder = new AutoResponder(client);
 const server = new McpServer({
     name: 'askmesh',
-    version: '0.1.0',
+    version: '0.2.0',
 });
 // Register all tools
 registerAskAgent(server, client);
@@ -25,10 +27,12 @@ registerListAgents(server, client);
 registerGetStatus(server, client);
 registerAnswerPending(server, client);
 registerSetContext(server, client);
-// Start SSE listener (marks agent online + receives incoming requests)
+// Give the auto-responder access to the underlying MCP server for sampling
+autoResponder.setServer(server.server);
+// Start SSE listener — auto-respond to incoming questions
 const sse = new SseListener();
-sse.start(URL, TOKEN, (request) => {
-    console.error(`[AskMesh] Incoming request from @${request.fromUsername}: "${request.question}"`);
+sse.start(URL, TOKEN, async (request) => {
+    await autoResponder.handleRequest(request);
 });
 // Cleanup on exit
 process.on('SIGINT', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askmesh/mcp",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "AskMesh MCP server — connect your AI coding agent to your team's mesh network",
   "type": "module",
   "bin": {
@@ -32,6 +32,7 @@
   "homepage": "https://askmesh.dev",
   "license": "MIT",
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "eventsource": "^2.0.2",
     "zod": "^4.3.6"