用 Claude Code 构建 MCP 服务器实战

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc   # 或 source ~/.zshrc

# 安装并使用最新 LTS Node
nvm install --lts
nvm use --lts

# 验证版本（需要 >= 20）
node --version

npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 首次运行，完成登录和权限初始化
# 注意：这会打开浏览器进行 OAuth 认证
claude --dangerously-skip-permissions "echo hello"

mkdir my-mcp-server && cd my-mcp-server
npm init -y

# 安装 MCP SDK 和必要的依赖
npm install @modelcontextprotocol/sdk zod

# TypeScript 支持
npm install -D typescript @types/node tsx

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"]
}

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import { execSync } from "child_process";
import { readFileSync, existsSync } from "fs";
import { resolve } from "path";

// 创建 MCP Server 实例
const server = new McpServer({
  name: "code-quality-server",
  version: "1.0.0",
});

// ── 工具 1：ESLint 检查 ──
server.tool(
  "lint_file",
  "对指定文件运行 ESLint 检查，返回格式化后的 lint 结果",
  {
    file_path: z.string().describe("要检查的文件路径（相对或绝对路径）"),
    fix: z.boolean().optional().describe("是否自动修复可修复的问题，默认 false"),
  },
  async ({ file_path, fix = false }) => {
    const absPath = resolve(file_path);
    if (!existsSync(absPath)) {
      return {
        content: [{ type: "text", text: `错误：文件不存在 ${absPath}` }],
        isError: true,
      };
    }

    try {
      const fixFlag = fix ? "--fix" : "";
      const result = execSync(
        `npx eslint ${fixFlag} --format=compact "${absPath}"`,
        { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }
      );
      return {
        content: [{ type: "text", text: result || "✓ 没有发现 lint 错误" }],
      };
    } catch (err: any) {
      // ESLint 发现问题时会以非零退出码退出，stdout 里有结果
      return {
        content: [{ type: "text", text: err.stdout || err.message }],
      };
    }
  }
);

// ── 工具 2：读取 package.json 依赖信息 ──
server.tool(
  "get_dependencies",
  "读取当前项目的 package.json，返回依赖列表和版本信息",
  {
    project_path: z.string().optional().describe("项目路径，默认当前目录"),
    type: z
      .enum(["all", "dependencies", "devDependencies"])
      .optional()
      .describe("依赖类型，默认 all"),
  },
  async ({ project_path = ".", type = "all" }) => {
    const pkgPath = resolve(project_path, "package.json");
    if (!existsSync(pkgPath)) {
      return {
        content: [{ type: "text", text: `未找到 package.json: ${pkgPath}` }],
        isError: true,
      };
    }

    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
    const result: Record = { name: pkg.name, version: pkg.version };

    if (type === "all" || type === "dependencies") {
      result.dependencies = pkg.dependencies || {};
    }
    if (type === "all" || type === "devDependencies") {
      result.devDependencies = pkg.devDependencies || {};
    }

    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }
);

// ── 启动服务 ──
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.error("Code Quality MCP Server running on stdio");
}

main().catch((err) => {
  console.error("Fatal error:", err);
  process.exit(1);
});

{
  "scripts": {
    "build": "tsc",
    "dev": "tsx src/index.ts"
  },
  "type": "module"
}

# 编译 TypeScript
npm run build

# 验证构建产物
ls build/

{
  "mcpServers": {
    "code-quality": {
      "command": "node",
      "args": ["/absolute/path/to/my-mcp-server/build/index.js"]
    }
  }
}