tokrepo-mcp-server 2.7.0 → 2.9.0

package/README.md

@@ -43,6 +43,8 @@ Once connected, your AI assistant can:
 - **Safe Codex install** — dry-run by default; risky assets must be staged or explicitly approved
 - **Lifecycle control** — list, update, uninstall, and roll back managed Codex installs
 - **Project memory** — pair with `tokrepo init-agent --target all` so future agents know to call TokRepo during planning
+- **Discovery surfaces** — official MCP `server.json`, A2A agent card, portable agent manifest, tool catalog, `.well-known`, `agents.txt`, `llms.txt`, and npm metadata are kept machine-readable for agents and registries
+- **Funnel visibility** — anonymous aggregate events show whether agents actually discover, plan, install, hand off, and push reusable assets
 
 ## Available Tools
 
@@ -82,7 +84,22 @@ Run this once in a project:
 npx tokrepo init-agent --target all
 ```
 
-It writes managed instructions to `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Cursor rules, and `.mcp.json`. The rule is simple: during planning, when the agent sees a capability gap, it should call `tokrepo_discover` before inventing a one-off local tool. After a task, agents can run `tokrepo agent-handoff --json` to suggest reusable files for user-confirmed private publishing.
+It writes managed instructions to `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Cursor rules, GitHub Copilot instructions, Cline rules, Windsurf rules, Roo rules, OpenHands microagents, Aider conventions, and `.mcp.json`. The rule is simple: during planning, when the agent sees a capability gap, it should call `tokrepo_discover` before inventing a one-off local tool. After a task, agents can run `tokrepo agent-handoff --json` to suggest reusable files for user-confirmed private publishing.
+
+## Machine-Readable Listing
+
+Registries and agents can discover this server through:
+
+- MCP server manifest: [tokrepo.com/.well-known/mcp/server.json](https://tokrepo.com/.well-known/mcp/server.json)
+- TokRepo manifest: [tokrepo.com/.well-known/tokrepo.json](https://tokrepo.com/.well-known/tokrepo.json)
+- Portable agent manifest: [tokrepo.com/.well-known/agent.json](https://tokrepo.com/.well-known/agent.json)
+- A2A agent card: [tokrepo.com/.well-known/agent-card.json](https://tokrepo.com/.well-known/agent-card.json)
+- Tool catalog: [tokrepo.com/.well-known/tool-catalog.json](https://tokrepo.com/.well-known/tool-catalog.json)
+- Agent text entry: [tokrepo.com/agents.txt](https://tokrepo.com/agents.txt)
+- Agent instructions: [tokrepo.com/agent-instructions/tokrepo.md](https://tokrepo.com/agent-instructions/tokrepo.md)
+- LLM crawler entry: [tokrepo.com/llms.txt](https://tokrepo.com/llms.txt)
+
+TokRepo emits anonymous aggregate funnel events for `tokrepo_discover`, `tokrepo_install_plan`, install dry-runs, installs, handoffs, and pushes. It does not send task text or file contents. Disable with `TOKREPO_TELEMETRY=0`.
 
 ## Why TokRepo?
 
@@ -102,7 +119,7 @@ TokRepo is the **open registry for AI assets** — like npm for packages, but fo
 
 - **Website**: [tokrepo.com](https://tokrepo.com)
 - **CLI**: [npm: tokrepo](https://www.npmjs.com/package/tokrepo)
-- **GitHub**: [tokrepo/mcp-server](https://github.com/tokrepo/mcp-server)
+- **GitHub**: [henu-wang/tokrepo-mcp-server](https://github.com/henu-wang/tokrepo-mcp-server)
 - **API**: [tokrepo.com/.well-known/tokrepo.json](https://tokrepo.com/.well-known/tokrepo.json)
 
 ## License

package/bin/server.js

@@ -12,6 +12,7 @@
  */
 
 const https = require('https');
+const http = require('http');
 const crypto = require('crypto');
 const { execFile } = require('child_process');
 
@@ -19,7 +20,7 @@ const API_BASE = process.env.TOKREPO_API || 'https://api.tokrepo.com';
 const TOKREPO_URL = 'https://tokrepo.com';
 const TOKREPO_TOKEN = process.env.TOKREPO_TOKEN || '';
 const TOKREPO_CLI = process.env.TOKREPO_CLI || '';
-const SERVER_VERSION = '2.7.0';
+const SERVER_VERSION = '2.9.0';
 
 // ─── MCP Protocol (JSON-RPC over stdio) ───
 
@@ -46,7 +47,7 @@ const TOOLS = [
         target: {
           type: 'string',
           description: 'Optional agent/runtime target. Use "any" for generic discovery.',
-          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'windsurf', 'mcp_client'],
+          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'copilot', 'cline', 'windsurf', 'roo', 'openhands', 'aider', 'mcp_client'],
           default: 'any',
         },
         environment: {
@@ -91,7 +92,7 @@ const TOOLS = [
         target: {
           type: 'string',
           description: 'Optional agent target filter. Use "any" or omit it for generic discovery.',
-          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'windsurf', 'mcp_client'],
+          enum: ['any', 'codex', 'claude_code', 'gemini_cli', 'cursor', 'copilot', 'cline', 'windsurf', 'roo', 'openhands', 'aider', 'mcp_client'],
         },
         kind: {
           type: 'string',
@@ -443,7 +444,85 @@ const EXPOSED_TOOL_NAMES = new Set([
   'tokrepo_push',
 ]);
 
-const EXPOSED_TOOLS = TOOLS.filter((tool) => EXPOSED_TOOL_NAMES.has(tool.name));
+const TOOL_ANNOTATIONS = {
+  tokrepo_discover: {
+    title: 'Discover reusable AI assets before inventing a one-off tool',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_search: {
+    title: 'Search reusable AI assets',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_detail: {
+    title: 'Read asset details and metadata',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_install_plan: {
+    title: 'Plan an install before any file write',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+  },
+  tokrepo_codex_install: {
+    title: 'Dry-run, stage, or install an asset for Codex',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+  },
+  tokrepo_installed: {
+    title: 'List locally installed TokRepo assets',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+  },
+  tokrepo_update: {
+    title: 'Dry-run or update installed TokRepo assets',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+  },
+  tokrepo_uninstall: {
+    title: 'Dry-run or uninstall a TokRepo-managed asset',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false,
+  },
+  tokrepo_rollback: {
+    title: 'Dry-run or roll back a TokRepo install session',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false,
+  },
+  tokrepo_push: {
+    title: 'Publish explicit reviewed files to TokRepo after confirmation',
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+  },
+};
+
+const EXPOSED_TOOLS = TOOLS
+  .filter((tool) => EXPOSED_TOOL_NAMES.has(tool.name))
+  .map((tool) => ({
+    ...tool,
+    annotations: TOOL_ANNOTATIONS[tool.name],
+  }));
 
 // ─── HTTP Helper ───
 
@@ -524,6 +603,72 @@ function apiPost(urlPath, body, token) {
   });
 }
 
+function telemetryDisabled() {
+  const value = String(process.env.TOKREPO_TELEMETRY || '').toLowerCase();
+  return ['0', 'false', 'off', 'no'].includes(value);
+}
+
+function eventForTool(name, args = {}) {
+  if (name === 'tokrepo_discover') return 'mcp_discover';
+  if (name === 'tokrepo_search') return 'mcp_search';
+  if (name === 'tokrepo_detail') return 'mcp_detail';
+  if (name === 'tokrepo_install_plan') return 'install_plan';
+  if (name === 'tokrepo_codex_install') return args.dry_run === false ? 'install_apply' : 'install_dry_run';
+  if (name === 'tokrepo_push') return 'push';
+  return '';
+}
+
+function candidateCountFromResult(result) {
+  const text = result?.content?.map(item => item.text || '').join('\n') || '';
+  return (text.match(/"uuid"\s*:/g) || []).length;
+}
+
+function trackAgentEventForTool(name, args = {}, result = {}) {
+  if (telemetryDisabled()) return;
+  const event = eventForTool(name, args);
+  if (!event) return;
+  try {
+    const url = new URL('/api/v1/tokenboard/agent/events', API_BASE);
+    if (url.protocol === 'http:' && !url.hostname.match(/^(localhost|127\.0\.0\.1)$/)) {
+      url.protocol = 'https:';
+    }
+    const body = JSON.stringify({
+      event,
+      source: 'mcp',
+      version: SERVER_VERSION,
+      target: args.target || args?.constraints?.target || 'any',
+      kind: args.kind || args?.constraints?.kind || '',
+      policy: args.policy || args?.constraints?.policy || '',
+      result: result?.isError ? 'error' : 'pass',
+      dry_run: name === 'tokrepo_codex_install' ? args.dry_run !== false : undefined,
+      candidate_count: candidateCountFromResult(result),
+    });
+    const isHttps = url.protocol === 'https:';
+    const mod = isHttps ? https : http;
+    const req = mod.request({
+      hostname: url.hostname,
+      port: url.port || (isHttps ? 443 : 80),
+      path: url.pathname,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+        'User-Agent': `tokrepo-mcp-server/${SERVER_VERSION}`,
+      },
+      timeout: 700,
+    }, (res) => {
+      res.resume();
+    });
+    req.on('socket', socket => socket.unref?.());
+    req.on('error', () => {});
+    req.on('timeout', () => req.destroy());
+    req.write(body);
+    req.end();
+  } catch {
+    // Telemetry is best-effort only.
+  }
+}
+
 function apiGetAuth(urlPath, token) {
   return new Promise((resolve, reject) => {
     const url = new URL(urlPath, API_BASE);
@@ -1423,6 +1568,7 @@ async function handleRequest(msg) {
       } catch (e) {
         result = { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
       }
+      trackAgentEventForTool(name, args || {}, result);
       return { jsonrpc: '2.0', id, result };
     }
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "tokrepo-mcp-server",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "description": "Agent-native MCP server for TokRepo — search, plan, safely install, and push AI assets from MCP clients.",
-  "mcpName": "io.github.tokrepo/mcp-server",
+  "mcpName": "io.github.henu-wang/tokrepo-mcp-server",
   "bin": {
     "tokrepo-mcp-server": "bin/server.js"
   },
@@ -12,7 +12,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tokrepo/mcp-server.git"
+    "url": "git+https://github.com/henu-wang/tokrepo-mcp-server.git"
   },
   "homepage": "https://tokrepo.com",
   "keywords": [
@@ -24,10 +24,23 @@
     "cursor",
     "codex",
     "gemini",
+    "copilot",
+    "cline",
+    "windsurf",
+    "openhands",
     "skills",
     "prompts",
     "workflows",
-    "agent"
+    "agent",
+    "agent-tools",
+    "agent-skills",
+    "claude-code",
+    "openai-codex",
+    "mcp-registry",
+    "agent-manifest",
+    "a2a-agent-card",
+    "tool-discovery",
+    "llms-txt"
   ],
   "engines": {
     "node": ">=18"