@ikhono/mcp 0.1.2 → 0.1.4

package/README.md

@@ -83,7 +83,7 @@ IKHONO_API_TOKEN=YOUR_TOKEN npx @ikhono/mcp
 
 | Tool | Description |
 |------|-------------|
-| `ikhono_skill_search` | Search for skills by query, category, or author |
+| `ikhono_skill_search` | Search for skills by query, category, or author (returns top 3 previews) |
 | `ikhono_skill_get` | Load a skill's full instructions by slug |
 | `ikhono_skill_pin` | Pin a skill to your favorites |
 | `ikhono_skill_unpin` | Remove a skill from your favorites |
@@ -92,7 +92,7 @@ IKHONO_API_TOKEN=YOUR_TOKEN npx @ikhono/mcp
 
 ### ikhono_skill_search
 
-Search for skills matching a query.
+Search for skills matching a query. Returns a concise preview of the top results (default: 3) with name, description, rating, and usage stats. Use `ikhono_skill_get` to load the full skill instructions.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -100,7 +100,7 @@ Search for skills matching a query.
 | `category` | string | No | Filter by category |
 | `author` | string | No | Filter by author (e.g., "@alice") |
 | `mine` | boolean | No | Show only your skills |
-| `limit` | number | No | Max results (default: 5) |
+| `limit` | number | No | Max results (default: 3) |
 
 ### ikhono_skill_get
 
@@ -135,9 +135,11 @@ Rate a skill after using it.
 ## How It Works
 
 1. Your AI agent receives a task (e.g., "review this code")
-2. The agent calls `ikhono_skill_search` to find relevant skills
-3. The agent calls `ikhono_skill_get` to load the skill's instructions
-4. The agent follows those instructions for a better, more structured response
+2. The agent calls `ikhono_skill_search` to find relevant skills (top 3 previews)
+3. The user picks which skill to load — the agent calls `ikhono_skill_get` with that slug
+4. The agent follows the skill's instructions for a better, more structured response
+
+If none of the results fit, the user can ask to search again with a higher `limit` or a different query.
 
 Skills are community-created Markdown documents with structured processes, checklists, and templates. The MCP server is a thin proxy to the iKhono API — no local storage or computation needed.
 

package/dist/index.js

@@ -85,9 +85,26 @@ var searchToolSchema = z.object({
   category: z.string().optional().describe('Filter by category (e.g., "security", "testing", "documentation")'),
   author: z.string().optional().describe('Filter by author username (e.g., "@alice" or "alice")'),
   mine: z.boolean().optional().describe("Set to true to show only your own skills (requires authentication)"),
-  limit: z.number().optional().default(5).describe("Maximum number of results to return")
+  limit: z.number().optional().default(3).describe("Maximum number of results to return")
 });
 var searchToolDescription = `Search iKhono for AI skills that match a query. Use this when the user asks you to do something that could benefit from specialized expertise. Returns a list of matching skills with their names, descriptions, ratings, usage counts, and pin counts.`;
+function formatSearchResults(results) {
+  if (results.length === 0) {
+    return "No skills found matching your query.";
+  }
+  const lines = [`Found ${results.length} skill${results.length === 1 ? "" : "s"}:
+`];
+  for (let i = 0; i < results.length; i++) {
+    const r = results[i];
+    const rating = r.avgRating > 0 ? `${r.avgRating.toFixed(1)}/5 (${r.ratingCount} rating${r.ratingCount === 1 ? "" : "s"})` : "no ratings yet";
+    lines.push(`${i + 1}. ${r.slug} (v${r.latestVersion})`);
+    lines.push(`   ${r.description}`);
+    lines.push(`   ${rating} \xB7 ${r.totalUses} uses \xB7 ${r.pinCount} pins`);
+    lines.push("");
+  }
+  lines.push("Load a skill with ikhono_skill_get using the slug.");
+  return lines.join("\n");
+}
 async function handleSearch(client2, args2) {
   const results = await client2.searchSkills(args2.query, {
     category: args2.category,
@@ -151,7 +168,7 @@ async function handleRate(client2, args2) {
 // src/version.ts
 import { createRequire } from "module";
 function getVersion() {
-  if (true) return "0.1.2";
+  if (true) return "0.1.4";
   const require2 = createRequire(import.meta.url);
   return require2("../package.json").version;
 }
@@ -168,7 +185,7 @@ function readCliConfig() {
 }
 var cliConfig = readCliConfig();
 var args = process.argv.slice(2);
-var apiUrl = "http://localhost:3456";
+var apiUrl = "https://ikhono.io";
 var token;
 for (let i = 0; i < args.length; i++) {
   if (args[i] === "--api-url" && args[i + 1]) {
@@ -179,7 +196,7 @@ for (let i = 0; i < args.length; i++) {
     i++;
   }
 }
-apiUrl = process.env.IKHONO_API_URL || apiUrl || cliConfig.apiUrl || "http://localhost:3456";
+apiUrl = process.env.IKHONO_API_URL || apiUrl || cliConfig.apiUrl || "https://ikhono.io";
 token = process.env.IKHONO_API_TOKEN || token || cliConfig.token;
 var client = new IkhonoClient({ apiUrl, token });
 var server = new McpServer({
@@ -188,15 +205,21 @@ var server = new McpServer({
 }, {
   instructions: `You have access to iKhono, a registry of AI skills that enhance your capabilities. When the user asks you to do something that could benefit from specialized expertise (code review, test writing, documentation, refactoring, etc.), use ikhono_skill_search to find relevant skills, then use ikhono_skill_get to load the skill's full instructions. Follow those instructions to give a better, more structured response. Always tell the user which skill you're using and its rating.`
 });
-server.tool(searchToolName, searchToolDescription, searchToolSchema.shape, async (args2) => {
+server.registerTool(searchToolName, {
+  description: searchToolDescription,
+  inputSchema: searchToolSchema.shape
+}, async (args2) => {
   try {
     const results = await handleSearch(client, searchToolSchema.parse(args2));
-    return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
+    return { content: [{ type: "text", text: formatSearchResults(results) }] };
   } catch (err) {
     return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
   }
 });
-server.tool(getSkillToolName, getSkillToolDescription, getSkillToolSchema.shape, async (args2) => {
+server.registerTool(getSkillToolName, {
+  description: getSkillToolDescription,
+  inputSchema: getSkillToolSchema.shape
+}, async (args2) => {
   try {
     const parsed = getSkillToolSchema.parse(args2);
     const skill = await handleGetSkill(client, parsed);
@@ -216,7 +239,10 @@ This helps skill creators improve their work.`;
     return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
   }
 });
-server.tool(pinToolName, pinToolDescription, pinToolSchema.shape, async (args2) => {
+server.registerTool(pinToolName, {
+  description: pinToolDescription,
+  inputSchema: pinToolSchema.shape
+}, async (args2) => {
   try {
     const result = await handlePin(client, pinToolSchema.parse(args2));
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -224,7 +250,10 @@ server.tool(pinToolName, pinToolDescription, pinToolSchema.shape, async (args2)
     return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
   }
 });
-server.tool(unpinToolName, unpinToolDescription, unpinToolSchema.shape, async (args2) => {
+server.registerTool(unpinToolName, {
+  description: unpinToolDescription,
+  inputSchema: unpinToolSchema.shape
+}, async (args2) => {
   try {
     const result = await handleUnpin(client, unpinToolSchema.parse(args2));
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -232,7 +261,10 @@ server.tool(unpinToolName, unpinToolDescription, unpinToolSchema.shape, async (a
     return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
   }
 });
-server.tool(listPinnedToolName, listPinnedToolDescription, listPinnedToolSchema.shape, async () => {
+server.registerTool(listPinnedToolName, {
+  description: listPinnedToolDescription,
+  inputSchema: listPinnedToolSchema.shape
+}, async () => {
   try {
     const result = await handleListPinned(client);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -240,7 +272,10 @@ server.tool(listPinnedToolName, listPinnedToolDescription, listPinnedToolSchema.
     return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
   }
 });
-server.tool(rateToolName, rateToolDescription, rateToolSchema.shape, async (args2) => {
+server.registerTool(rateToolName, {
+  description: rateToolDescription,
+  inputSchema: rateToolSchema.shape
+}, async (args2) => {
   try {
     const result = await handleRate(client, rateToolSchema.parse(args2));
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikhono/mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "iKhono MCP Server — runtime skill router for AI agents",
   "type": "module",
   "bin": {