tokrepo-mcp-server 2.2.0 → 2.4.0

package/README.md

@@ -35,18 +35,19 @@ gemini settings mcp add tokrepo -- npx -y tokrepo-mcp-server
 
 Once connected, your AI assistant can:
 
-- **Search** 200+ curated AI assets by keyword or category
+- **Search** 200+ curated AI assets by keyword or category with Codex-first `agent_fit` ranking
 - **Browse** trending assets, filter by type (MCP, Skill, Prompt, Agent, Script)
 - **Get details** — full documentation, install instructions, and metadata
 - **Plan before install** — get install plan v2 with policy decisions, rollback, and verification
 - **Safe Codex install** — dry-run by default; risky assets must be staged or explicitly approved
 - **Lifecycle control** — list installed assets, uninstall managed files, and roll back install sessions
+- **Agent eval** — run TokRepo's agent-native search/plan/install/rollback contract checks
 
 ## Available Tools
 
 | Tool | Description |
 |------|-------------|
-| `tokrepo_search` | Search assets by keyword and tag |
+| `tokrepo_search` | Search assets by keyword/tag with `agent_fit` ranking |
 | `tokrepo_detail` | Get full asset details by UUID |
 | `tokrepo_install_plan` | Get agent-native install plan v2 |
 | `tokrepo_codex_install` | Dry-run, stage, or install a Codex skill safely |
@@ -54,6 +55,7 @@ Once connected, your AI assistant can:
 | `tokrepo_installed` | List TokRepo-managed Codex installs |
 | `tokrepo_uninstall` | Dry-run or remove a managed Codex install |
 | `tokrepo_rollback` | Dry-run or roll back a prior Codex install session |
+| `tokrepo_eval_agent` | Run agent-native CLI contract and lifecycle evals |
 | `tokrepo_install` | Get raw installable content |
 | `tokrepo_trending` | Browse popular/latest assets |
 
@@ -70,6 +72,7 @@ You: "Install that cursor rules asset"
 AI: [calls tokrepo_install_plan] → Reviews policy and actions
 AI: [calls tokrepo_codex_install with dry_run=false, confirm=true] → Writes only after explicit confirmation
 AI: [calls tokrepo_rollback with dry_run=true] → Shows exactly what would be removed before rollback
+AI: [calls tokrepo_eval_agent] → Verifies TokRepo's agent-facing flow end to end
 ```
 
 ## Why TokRepo?

package/bin/server.js

@@ -19,7 +19,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.2.0';
+const SERVER_VERSION = '2.4.0';
 
 // ─── MCP Protocol (JSON-RPC over stdio) ───
 
@@ -55,8 +55,9 @@ const TOOLS = [
         },
         target: {
           type: 'string',
-          description: 'Optional agent target filter. Use codex for Codex-compatible assets.',
+          description: 'Agent target filter. Defaults to codex so results include agent_fit ranking for installable Codex assets.',
           enum: ['codex'],
+          default: 'codex',
         },
         kind: {
           type: 'string',
@@ -245,6 +246,23 @@ const TOOLS = [
       },
     },
   },
+  {
+    name: 'tokrepo_eval_agent',
+    description: 'Run TokRepo agent-native evals through the CLI. Verifies filtered search, install-plan contracts, metadata quality reporting, Codex install verification, manifest state, and rollback using temporary local state.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        uuid: {
+          type: 'string',
+          description: 'Optional sample asset UUID for install-plan and lifecycle tests.',
+        },
+        keyword: {
+          type: 'string',
+          description: 'Optional search keyword for filtered search eval. Default video.',
+        },
+      },
+    },
+  },
   {
     name: 'tokrepo_trending',
     description: 'Get trending/popular AI assets on TokRepo. Use when user asks for recommended or popular AI tools.',
@@ -519,7 +537,7 @@ function jsonText(title, data) {
 // ─── Tool Handlers ───
 
 async function handleSearch(args) {
-  const { query, tag, limit = 10, target = '', kind = '', policy = '' } = args;
+  const { query, tag, limit = 10, target = 'codex', kind = '', policy = '' } = args;
   if (target || kind || policy) {
     const cliArgs = ['search', query, '--json', '--page-size', String(Math.min(limit, 20))];
     if (target) cliArgs.push('--target', target);
@@ -803,6 +821,21 @@ async function handleRollback(args) {
   return { content: [{ type: 'text', text: jsonText(dry_run === false ? 'TokRepo Codex rollback result' : 'TokRepo Codex rollback dry-run', data) }] };
 }
 
+async function handleEvalAgent(args) {
+  const { uuid = '', keyword = '' } = args || {};
+  const cliArgs = ['eval-agent', '--json'];
+  if (uuid) cliArgs.push('--uuid', uuid);
+  if (keyword) cliArgs.push('--keyword', keyword);
+  const { stdout, stderr } = await runTokrepoCli(cliArgs);
+  let data;
+  try {
+    data = JSON.parse(stdout);
+  } catch {
+    data = { stdout, stderr };
+  }
+  return { content: [{ type: 'text', text: jsonText('TokRepo agent eval result', data) }] };
+}
+
 async function handleTrending(args) {
   const { sort = 'popular', limit = 10 } = args;
   const params = new URLSearchParams({
@@ -957,6 +990,7 @@ async function handleRequest(msg) {
           case 'tokrepo_installed': result = await handleInstalled(args || {}); break;
           case 'tokrepo_uninstall': result = await handleUninstall(args || {}); break;
           case 'tokrepo_rollback': result = await handleRollback(args || {}); break;
+          case 'tokrepo_eval_agent': result = await handleEvalAgent(args || {}); break;
           case 'tokrepo_trending': result = await handleTrending(args || {}); break;
           case 'tokrepo_push': result = await handlePush(args || {}); break;
           case 'tokrepo_status': result = await handleStatus(args || {}); break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokrepo-mcp-server",
-  "version": "2.2.0",
+  "version": "2.4.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",
   "bin": {