CLI 与 MCP 深度分析：AI 工具链的架构演进

用户输入 ──► Shell 解析 ──► 进程调用 ──► 标准 I/O
                │                          │
                └── 参数解析 (argc/argv)   └── stdout / stderr / stdin

my-tool [全局选项] <子命令> [子命令选项] [参数...]
   │         │           │          │
   │     --verbose    commit     <file>
   │     --config=   push
   └── 工具名称       pull

# 安装
npm install -g @anthropic-ai/claude-code

# 基础使用
claude                          # 交互模式
claude "解释这段代码"            # 单次问答
claude -p "重构此函数" < foo.py  # 管道输入

# 非交互模式（适合 CI/CD）
claude --print "生成单元测试"
claude --output-format json "分析依赖"

终端用户
    │
    ▼
Claude Code CLI
    ├── 自然语言解析层
    ├── 工具执行引擎
    │     ├── 文件读写
    │     ├── Bash 执行
    │     ├── 代码搜索
    │     └── Git 操作
    ├── 上下文管理（CLAUDE.md）
    └── MCP Client（连接外部服务）

┌─────────────────────────────────────────────────────────┐
│                     MCP 生态全貌                         │
│                                                          │
│  ┌──────────────┐    MCP Protocol    ┌────────────────┐  │
│  │  MCP Client  │◄──────────────────►│   MCP Server   │  │
│  │              │                    │                │  │
│  │  - Claude    │   JSON-RPC 2.0     │  - 文件系统    │  │
│  │  - IDE插件   │   over stdio/HTTP  │  - 数据库      │  │
│  │  - 自定义应用│                    │  - GitHub      │  │
│  └──────────────┘                    │  - Slack       │  │
│                                      │  - 自定义服务  │  │
│                                      └────────────────┘  │
└─────────────────────────────────────────────────────────┘

{
  "name": "create_file",
  "description": "在指定路径创建新文件",
  "inputSchema": {
    "type": "object",
    "properties": {
      "path": { "type": "string", "description": "文件路径" },
      "content": { "type": "string", "description": "文件内容" }
    },
    "required": ["path", "content"]
  }
}

{
  "uri": "file:///project/src/main.py",
  "name": "main.py",
  "mimeType": "text/x-python"
}

{
  "name": "code_review",
  "description": "执行代码审查",
  "arguments": [
    { "name": "code", "required": true },
    { "name": "language", "required": false }
  ]
}

Host进程 ──► 子进程(MCP Server)
         stdout/stdin 双向通信
         适合：本地工具、命令行集成

MCP Client ──HTTP POST──► MCP Server
           ◄──SSE Stream──
           适合：远程服务、Web 集成、多客户端

Client                          Server
  │                               │
  │── initialize ──────────────► │  协商协议版本、能力
  │◄─ initialized ────────────── │
  │                               │
  │── tools/list ───────────────► │  发现可用工具
  │◄─ [tool1, tool2, ...] ─────── │
  │                               │
  │── tools/call ───────────────► │  调用具体工具
  │   { name, arguments }         │
  │◄─ { content, isError } ────── │  返回结果
  │                               │

from mcp.server import Server
from mcp.server.stdio import stdio_server
from mcp.types import Tool, TextContent
import json

app = Server("my-analysis-server")

@app.list_tools()
async def list_tools() -> list[Tool]:
    return [
        Tool(
            name="analyze_data",
            description="分析数据集并返回统计摘要",
            inputSchema={
                "type": "object",
                "properties": {
                    "dataset": {"type": "array"},
                    "metrics": {
                        "type": "array",
                        "items": {"enum": ["mean", "median", "std"]}
                    }
                },
                "required": ["dataset"]
            }
        )
    ]

@app.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "analyze_data":
        data = arguments["dataset"]
        metrics = arguments.get("metrics", ["mean"])
        
        result = {}
        if "mean" in metrics:
            result["mean"] = sum(data) / len(data)
        if "median" in metrics:
            sorted_data = sorted(data)
            n = len(sorted_data)
            result["median"] = sorted_data[n // 2]
        
        return [TextContent(type="text", text=json.dumps(result, ensure_ascii=False))]

async def main():
    async with stdio_server() as (read_stream, write_stream):
        await app.run(read_stream, write_stream, app.create_initialization_options())

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

用户 ──文本命令──► CLI工具 ──处理──► 文本输出 ──► 用户
                     │
                  exec/fork
                     │
                  子进程

用户 ──自然语言──► AI模型 ──结构化调用──► MCP Server ──结果──► AI模型 ──自然语言──► 用户
                    │                         │
                 推理规划                   工具执行
                    │                         │
                上下文管理              安全边界检查

启动进程 → 继承父进程权限 → 全量文件系统访问 → 风险：权限过大

AI 请求工具调用
      │
      ▼
人工确认（Human-in-the-loop）
      │
      ▼
Server 执行（仅声明的工具范围内）
      │
      ▼
结果返回给 AI（无法访问未声明的资源）

开发者
  │
  │ $ claude "帮我重构数据库访问层"
  │
  ▼
Claude Code CLI（人机接口层）
  │
  ├── 解析自然语言意图
  ├── 管理会话上下文（.claude/）
  │
  ▼
Claude 模型（推理层）
  │
  ├── 分析代码库
  ├── 制定重构计划
  │
  ▼
工具执行层
  ├── 内置工具（文件读写、Bash）
  │
  └── MCP 工具（动态扩展）
        ├── postgres MCP Server → 查询数据库结构
        ├── github MCP Server  → 获取 PR 历史
        └── custom MCP Server  → 公司内部规范检查

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    }
  }
}

┌─────────────────────────────────────────────────────┐
│                  选择决策树                          │
│                                                     │
│  你的主要用户是谁？                                  │
│       │                                             │
│  ┌────┴────┐                                        │
│  │  人类   │  →  构建 CLI（配合 MCP Client 能力）   │
│  └─────────┘                                        │
│  ┌──────────┐                                       │
│  │ AI 模型  │  →  构建 MCP Server                  │
│  └──────────┘                                       │
│  ┌──────────┐                                       │
│  │  两者    │  →  CLI 暴露为 MCP Server             │
│  └──────────┘     （最佳实践）                      │
└─────────────────────────────────────────────────────┘