每天10分钟轻松掌握MCP（适合小白）：Day 5 - MCP环境初体验与工具链熟悉（二）

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

欢迎回到我们的MCP实战现场！如果说第一部分是"搭建舞台"，那么第二部分就是"正式演出"的时候了！现在让我们亲自操刀，看看这个MCP到底有多神奇！🎭

三、“开机启动”：第一次真正的握手

3.1 启动Claude Desktop并验证连接

现在是激动人心的时刻！让我们启动Claude Desktop，看看我们的配置是否生效：

启动检查清单：

实际启动过程：

# 1. 手动测试服务器是否能正常启动
cd /path/to/your/project
python fs_server.py

# 如果看到类似输出，说明服务器准备就绪：
# INFO: MCP Server listening on stdio
# INFO: Available tools: ['read_file', 'list_directory']

3.2 界面变化观察

启动成功后，你会发现Claude Desktop界面发生了微妙但重要的变化：

界面变化对比表：

3.3 第一次工具调用体验

现在让我们进行第一次实际的MCP工具调用！就像第一次开车上路一样，既紧张又兴奋！

测试用例1：目录浏览

在Claude Desktop中输入以下对话：

用户：请帮我查看一下Documents文件夹里有什么文件？

Claude的响应流程：

测试用例2：文件读取

让我们创建一个测试文件，然后尝试读取它：

# 首先创建一个测试文件
echo "Hello MCP World! 这是我的第一个MCP测试文件。" > ~/Documents/mcp_test.txt

然后在Claude Desktop中询问：

用户：能帮我读取一下Documents/mcp_test.txt文件的内容吗？

实际代码调试示例：

# 如果遇到编码问题，可以这样改进fs_server.py
@server.call_tool()
async def handle_call_tool(name: str, arguments: dict) -> list[TextContent]:
    if name == "read_file":
        file_path = arguments["file_path"]
        try:
            # 支持多种编码格式
            encodings = ['utf-8', 'gbk', 'utf-16']
            content = None
            
            for encoding in encodings:
                try:
                    with open(file_path, 'r', encoding=encoding) as f:
                        content = f.read()
                    break  # 成功读取就退出循环
                except UnicodeDecodeError:
                    continue  # 尝试下一种编码
            
            if content is None:
                return [TextContent(
                    type="text",
                    text="文件读取失败：无法识别文件编码"
                )]
                
            return [TextContent(
                type="text",
                text=f"文件内容：\n```\n{content}\n```"
            )]
        except FileNotFoundError:
            return [TextContent(
                type="text",
                text="错误：文件不存在，请检查路径是否正确"
            )]
        except PermissionError:
            return [TextContent(
                type="text",
                text="错误：没有权限访问该文件"
            )]

四、“对比实验”：启用MCP前后的天壤之别

4.1 功能对比实验

让我们做个有趣的对比实验，看看MCP到底给Claude带来了什么超能力：

实验设计表：

4.2 实际体验对比

场景1：分析CSV文件

# 无MCP时的对话：
用户：帮我分析这个销售数据CSV文件
Claude：请将CSV文件的内容复制粘贴给我，我来帮你分析

# 有MCP时的对话：
用户：帮我分析Documents/sales_data.csv文件
Claude：我来读取并分析这个文件... [自动调用read_file工具]
分析结果：发现1000条销售记录，总销售额$50万...

场景2：文件整理

# 可以为MCP服务器添加更多实用工具
@server.list_tools()
async def handle_list_tools() -> list[Tool]:
    return [
        # ... 之前的工具 ...
        Tool(
            name="organize_files",
            description="按类型整理文件到不同文件夹",
            inputSchema={
                "type": "object",
                "properties": {
                    "source_directory": {"type": "string"},
                    "organize_by": {
                        "type": "string", 
                        "enum": ["extension", "date", "size"]
                    }
                }
            }
        ),
        Tool(
            name="file_statistics",
            description="获取目录的文件统计信息",
            inputSchema={
                "type": "object",
                "properties": {
                    "directory_path": {"type": "string"}
                }
            }
        )
    ]

@server.call_tool()
async def handle_call_tool(name: str, arguments: dict) -> list[TextContent]:
    # ... 现有代码 ...
    
    elif name == "file_statistics":
        directory_path = arguments["directory_path"]
        try:
            files = os.listdir(directory_path)
            
            stats = {
                "总文件数": len(files),
                "文件类型": {},
                "总大小": 0
            }
            
            for file in files:
                file_path = os.path.join(directory_path, file)
                if os.path.isfile(file_path):
                    # 统计文件类型
                    ext = os.path.splitext(file)[1].lower()
                    stats["文件类型"][ext] = stats["文件类型"].get(ext, 0) + 1
                    
                    # 统计文件大小
                    stats["总大小"] += os.path.getsize(file_path)
            
            # 格式化大小显示
            size_mb = stats["总大小"] / (1024 * 1024)
            
            result = f"📊 目录统计报告：\n"
            result += f"📁 总文件数：{stats['总文件数']}\n"
            result += f"💾 总大小：{size_mb:.2f} MB\n\n"
            result += "📋 文件类型分布：\n"
            
            for ext, count in stats["文件类型"].items():
                ext_name = ext if ext else "无扩展名"
                result += f"  • {ext_name}: {count}个\n"
            
            return [TextContent(type="text", text=result)]
            
        except Exception as e:
            return [TextContent(
                type="text",
                text=f"统计失败：{str(e)}"
            )]

4.3 故障排除指南

在实际操作中，你可能会遇到一些小问题。别担心，这就像新手开车时偶尔熄火一样，很正常！😄

常见问题诊断表：

快速诊断命令：

# 1. 检查Python是否正常
python --version

# 2. 检查MCP库是否安装
python -c "import mcp; print('MCP库正常')"

# 3. 测试服务器启动
python fs_server.py
# 应该看到：INFO: MCP Server listening on stdio

# 4. 检查配置文件语法
python -m json.tool claude_desktop_config.json
# 如果有语法错误会报告具体位置

4.4 性能体验对比

响应速度对比：

现在你已经完成了MCP环境的完整体验！通过这个过程，你应该能够：

1. 直观感受：看到了MCP如何让AI助手"长出手脚"，能够真正操作文件系统
2. 技术理解：了解了客户端-服务器的通信机制和JSON数据交换
3. 实用价值：体验到了MCP带来的效率提升和功能扩展
4. 问题解决：掌握了基本的故障排除方法

这就像学会了驾驶的基本技能，现在你已经可以在MCP的"道路"上行驶了！虽然还不能上"高速公路"，但已经足够在"市区"里自由穿行了。

记住，最好的学习方法就是多练习。试着修改服务器代码，添加新的工具，或者处理不同类型的文件。每一次实践都会让你对MCP有更深的理解！🚗💨

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