keplr-wallet-mcp: Skill for Claude Code

MCP Tool Builder

Quick Start

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer(
  { name: "my-server", version: "1.0.0" },
  { capabilities: { tools: {}, resources: {}, prompts: {}, logging: {} } }
);

// Tool 등록
server.registerTool("greet", {
  description: "Greet a user",
  inputSchema: { name: z.string().describe("User name") },
}, async ({ name }) => ({
  content: [{ type: "text", text: `Hello, ${name}!` }],
}));

// 연결
await server.connect(new StdioServerTransport());

Tool 구현

기본 패턴

server.registerTool(
  "tool-name",
  {
    title: "Display Name",           // 선택
    description: "Tool description", // 필수
    inputSchema: {                   // Zod 스키마
      param1: z.string().describe("Parameter description"),
      param2: z.number().optional().default(10),
    },
    annotations: {                   // 선택
      readOnlyHint: true,            // 읽기 전용 (상태 변경 없음)
      destructiveHint: false,        // 파괴적 작업 아님
      idempotentHint: true,          // 멱등성 (반복 호출 안전)
    },
  },
  async (args, extra) => {
    // args: 파싱된 인자
    // extra: { signal, sessionId, authInfo, _meta, sendNotification }
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }
);

응답 타입

// 텍스트 (JSON 권장)
{ content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }

// 에러
{ content: [{ type: "text", text: JSON.stringify({ error: msg }) }], isError: true }

// 이미지
{ content: [{ type: "image", data: base64String, mimeType: "image/png" }] }

// 구조화된 출력 (outputSchema 정의 시)
{
  content: [{ type: "text", text: "..." }],
  structuredContent: { key: "value" }
}

Tool Annotations