Claude Code MCP Server 深度指南：把 AI 助手变成全栈开发平台

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

# 添加 stdio 类型的 Server
claude mcp add github -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github
 
# 添加远程 Server
claude mcp add remote-server --transport http --url https://example.com/mcp
 
# 指定配置层级
claude mcp add github --scope user -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github
claude mcp add github --scope project -- npx -y @modelcontextprotocol/server-github
 
# 查看已配置的 Server
claude mcp list
 
# 删除 Server
claude mcp remove github

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_xxxxxxxxxxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github@2.2.0"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

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: "weather-server",
  version: "1.0.0",
});
 
// 定义一个工具
server.tool(
  "get-weather",
  "获取指定城市的天气信息",
  {
    city: z.string().describe("城市名称，如 Beijing"),
  },
  async ({ city }) => {
    // 实际项目中调用天气 API
    const response = await fetch(
      `https://api.weatherapi.com/v1/current.json?key=${process.env.WEATHER_API_KEY}&q=${city}`
    );
    const data = await response.json();
 
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(data, null, 2),
        },
      ],
    };
  }
);
 
// 启动 Server
const transport = new StdioServerTransport();
await server.connect(transport);

from mcp.server.fastmcp import FastMCP
 
mcp = FastMCP("my-server")
 
@mcp.tool()
def query_inventory(product_id: str) -> str:
    """查询产品库存信息"""
    # 实际项目中查询数据库
    return f"产品 {product_id} 库存: 42 件"
 
@mcp.tool()
def update_price(product_id: str, new_price: float) -> str:
    """更新产品价格"""
    # 实际项目中更新数据库
    return f"产品 {product_id} 价格已更新为 {new_price}"
 
if __name__ == "__main__":
    mcp.run(transport="stdio")

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["./mcp-servers/weather/index.js"]
    },
    "inventory": {
      "command": "python",
      "args": ["./mcp-servers/inventory/server.py"]
    }
  }
}

claude mcp add weather -- node ./mcp-servers/weather/index.js
claude mcp add inventory -- python ./mcp-servers/inventory/server.py

# 安装 MCP Inspector
npx @modelcontextprotocol/inspector
 
# 测试你的 Server
npx @modelcontextprotocol/inspector node ./mcp-servers/weather/index.js

{
  "mcpServers": {
    "dart": {
      "command": "dart",
      "args": ["tooling-daemon", "--mcp"]
    },
    "figma": {
      "command": "npx",
      "args": ["-y", "figma-developer-mcp", "--figma-api-key=fig_xxx"]
    },
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest"],
      "env": {
        "FIREBASE_TOKEN": "your-firebase-token"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

class ProductCard extends StatelessWidget {
  final String imageUrl;
  final String title;
  final double price;
 
  const ProductCard({
    super.key,
    required this.imageUrl,
    required this.title,
    required this.price,
  });
 
  @override
  Widget build(BuildContext context) {
    return Container(
      decoration: BoxDecoration(
        borderRadius: BorderRadius.circular(12),
        boxShadow: [
          BoxShadow(
            color: Colors.black.withValues(alpha: 0.1),
            blurRadius: 8,
            offset: const Offset(0, 2),
          ),
        ],
      ),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          AspectRatio(
            aspectRatio: 4 / 3,
            child: Image.network(imageUrl, fit: BoxFit.cover),
          ),
          Padding(
            padding: const EdgeInsets.all(16),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                Text(title,
                    style: const TextStyle(
                        fontSize: 16, fontWeight: FontWeight.w600)),
                const SizedBox(height: 4),
                Text('¥${price.toStringAsFixed(2)}',
                    style: const TextStyle(
                        fontSize: 20, color: Color(0xFFE53935))),
              ],
            ),
          ),
        ],
      ),
    );
  }
}

# 用 Inspector 调试
npx @modelcontextprotocol/inspector npx -y @modelcontextprotocol/server-github
 
# 手动运行 Server 查看错误输出
npx -y @modelcontextprotocol/server-github 2>&1

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

server.tool("risky-operation", "执行风险操作", {}, async () => {
  try {
    const result = await doSomething();
    return { content: [{ type: "text", text: result }] };
  } catch (error) {
    return {
      content: [{ type: "text", text: `错误: ${error.message}` }],
      isError: true,
    };
  }
});