第5天：MCP环境初体验与工具链熟悉（一）

嗨！欢迎来到我们MCP学习之旅的第5天！今天我们要从"纸上谈兵"正式进入"真枪实弹"的实战阶段。就像学开车一样，光看理论是不够的，得真正坐进驾驶座踩踩油门才行！😄

今天我们的任务很明确：让Claude Desktop和MCP服务器"牵手成功"，体验一把MCP技术的真实魅力。别担心，我会像GPS导航一样，一步步带你走完整个流程！

一、Claude Desktop：我们的"驾驶舱"

1.1 什么是Claude Desktop？

Claude Desktop就像是MCP世界的"浏览器"，它不仅是一个聊天工具，更是连接各种MCP服务器的桥梁。想象一下，如果MCP服务器是各种"插件"，那Claude Desktop就是装载这些插件的"主机"。

1.2 安装Claude Desktop

系统要求对比表：

操作系统	最低版本	推荐配置	特殊说明
Windows	Windows 10	Windows 11	需要启用开发者模式
macOS	macOS 11	macOS 13+	需要允许未知来源应用
Linux	Ubuntu 20.04+	Ubuntu 22.04+	需要安装额外依赖

安装步骤（以Windows为例）：

1. 下载安装包

   • 访问 Claude Desktop 官方下载页面
   • 选择对应系统版本（这里别选错了，就像买鞋一样得选对码！）

2. 安装过程

   • 双击安装包，选择"为所有用户安装"
   • 安装路径建议保持默认（除非你的C盘真的满了）
   • 等待安装完成（喝杯咖啡的时间☕）

3. 首次启动检查

   # 验证安装是否成功（在命令行中）
   claude-desktop --version
   # 应该输出类似：Claude Desktop v1.2.3
   

1.3 初始配置文件解析

Claude Desktop的配置文件就像是"通讯录"，告诉它去哪里找MCP服务器。这个文件的位置因系统而异：

配置文件位置表：

操作系统	配置文件路径	配置文件名
Windows	%APPDATA%\Claude\	claude_desktop_config.json
macOS	~/Library/Application Support/Claude/	claude_desktop_config.json
Linux	~/.config/claude/	claude_desktop_config.json

基础配置文件结构：

{
  "mcpServers": {
    "服务器名称": {
      "command": "服务器启动命令",
      "args": ["参数1", "参数2"],
      "env": {
        "环境变量名": "环境变量值"
      }
    }
  },
  "globalShortcut": "Ctrl+Shift+Space",
  "theme": "auto"
}

让我们来看一个"活生生"的例子：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    },
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    }
  },
  "globalShortcut": "Ctrl+Shift+C",
  "theme": "dark"
}

配置文件参数详解：

参数	作用	举例	小贴士
command	启动MCP服务器的主命令	"python", "node"	确保命令在PATH中可用
args	传递给命令的参数列表	["-m", "server"]	参数顺序很重要！
env	环境变量设置	{"API_KEY": "xxx"}	敏感信息要小心处理

二、第一次"牵手"：连接文件系统MCP服务器

2.1 选择我们的第一个"伙伴"

今天我们选择文件系统访问器作为第一个MCP服务器，为什么呢？

• 简单直观：就像Windows资源管理器一样，大家都熟悉
• 即时反馈：操作结果立即可见
• 安全可控：只访问指定目录，不会"胡作非为"

2.2 安装文件系统MCP服务器

方法一：使用npm（推荐）

# 全局安装
npm install -g @modelcontextprotocol/server-filesystem

# 验证安装
npx @modelcontextprotocol/server-filesystem --help

方法二：使用Python版本

# 首先安装MCP Python SDK
pip install mcp

# 创建简单的文件系统服务器
# 文件名：fs_server.py
import asyncio
import os
from mcp.server import Server
from mcp.server.models import InitializationOptions
from mcp.types import *

server = Server("filesystem-server")

@server.list_tools()
async def handle_list_tools() -> list[Tool]:
    """列出可用的工具"""
    return [
        Tool(
            name="read_file",
            description="读取文件内容",
            inputSchema={
                "type": "object",
                "properties": {
                    "file_path": {
                        "type": "string",
                        "description": "要读取的文件路径"
                    }
                },
                "required": ["file_path"]
            }
        ),
        Tool(
            name="list_directory",
            description="列出目录内容",
            inputSchema={
                "type": "object", 
                "properties": {
                    "directory_path": {
                        "type": "string",
                        "description": "要列出的目录路径"
                    }
                },
                "required": ["directory_path"]
            }
        )
    ]

@server.call_tool()
async def handle_call_tool(name: str, arguments: dict) -> list[TextContent]:
    """处理工具调用"""
    if name == "read_file":
        file_path = arguments["file_path"]
        # 安全检查：确保路径在允许的目录内
        allowed_dir = "/Users/username/Documents/mcp_test"
        if not os.path.abspath(file_path).startswith(allowed_dir):
            return [TextContent(
                type="text",
                text="错误：文件路径超出允许范围"
            )]
        
        try:
            with open(file_path, 'r', encoding='utf-8') as f:
                content = f.read()
            return [TextContent(
                type="text", 
                text=f"文件内容：\n{content}"
            )]
        except Exception as e:
            return [TextContent(
                type="text",
                text=f"读取文件失败：{str(e)}"
            )]
    
    elif name == "list_directory":
        directory_path = arguments["directory_path"]
        try:
            files = os.listdir(directory_path)
            file_list = "\n".join(files)
            return [TextContent(
                type="text",
                text=f"目录内容：\n{file_list}"
            )]
        except Exception as e:
            return [TextContent(
                type="text",
                text=f"列出目录失败：{str(e)}"
            )]

async def main():
    # 通过stdio运行服务器
    async with server:
        await server.run()

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

2.3 配置连接

现在让我们更新Claude Desktop的配置文件，建立连接：

{
  "mcpServers": {
    "filesystem": {
      "command": "python",
      "args": ["C:/path/to/your/fs_server.py"],
      "env": {
        "PYTHONPATH": "C:/path/to/your/project"
      }
    }
  }
}

重要提醒： 路径要用你实际的路径替换，别直接复制粘贴！就像填家庭住址一样，得填自己的，不能填别人的😊

2.4 MCP连接流程图这就是我们第一部分的内容！我们已经完成了MCP环境搭建的"地基工程"：

1. Claude Desktop安装：我们的主要工作平台已经就位
2. 配置文件理解：学会了如何"告诉"Claude Desktop去哪里找MCP服务器
3. 第一个服务器连接：选择了最友好的文件系统服务器作为入门伙伴
4. 连接流程掌握：通过流程图清晰地看到了整个连接过程

现在你的MCP开发环境已经搭建完成，就像搭建好了一个"舞台"，接下来在第二部分，我们将真正"登台表演"，看看这个舞台能为我们带来什么精彩的表现！

记住，如果在配置过程中遇到问题，不要慌张。就像第一次学骑自行车一样，摔几次是正常的，关键是要坚持下去。大部分问题都是路径配置或权限设置的小问题，仔细检查一下就能解决！🚀

---

欢迎大家关注同名公众号《凡人的工具箱》：关注就送学习大礼包