MCP File Assistant Workshop

🛠️ MCP文件助理工作坊

实践工作坊教授+40名开发人员使用模型上下文协议构建他们的第一个AI驱动的文件助理。

2025年12月10日在布里斯班建筑俱乐部展出

📚 车间材料

🎯 本次工作坊所教授的内容

与会者学习构建一个MCP服务器，使人工智能助手（如克劳德）能够智能地与本地文件交互——阅读、搜索和组织文档。

🏗️ 建筑

MCP Architecture Diagram

🛠️ 技术栈

• Python 3.11+
• MCP-SDK
• 文件系统操作
• 语义搜索功能

📚 厂房结构

第1部分：MCP基础（15分钟）

• 什么是模型上下文协议？
• 为什么MCP与传统API相比？
• 文件管理用例

第2部分：构建服务器（20分钟）

• 初始化MCP服务器
• 执行文件操作
• 添加搜索功能

第3部分：集成与测试（10分钟）

• 连接到克劳德桌面
• 测试文件操作
• 调试常见问题

💡 关键学习成果

• 了解MCP协议基础知识
• 构建生产就绪的MCP服务器
• 将AI与本地文件系统集成
• 处理错误和边缘情况

🚀 快速开始

第一步：获取代码

git clone https://github.com/EllaFerreira/mcp-file-assistant-workshop.git
cd mcp-file-assistant-workshop

第二步：安装所有内容

# This step creates a virtual environment
uv venv

# Activate it
source .venv/bin/activate     # Mac/Linux
.venv\Scripts\activate        # Windows

# Install dependencies
uv pip install -e .

第三步：找到你的完整路径

pwd    # Mac/Linux
cd     # Windows

复制此路径！ 下一步您将需要它©

步骤4：连接到克劳德桌面

确保您安装了Claude Desktop， 点击此处.

查找配置文件：

• 雨衣： 打开 ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： 打开 %APPDATA%\Claude\claude_desktop_config.json
• Linux： 打开 ~/.config/Claude/claude_desktop_config.json

添加以下内容（将YOUR_PATH替换为您复制的路径）：

{
  "mcpServers": {
    "file-assistant": {
      "command": "YOUR_PATH/.venv/bin/python",
      "args": [
        "YOUR_PATH/file_assistant/server.py"
      ]
    }
  }
}

例子：

{
  "mcpServers": {
    "file-assistant": {
      "command": "/Users/EllaFerreira/mcp-file-assistant-workshop/.venv/bin/python",
      "args": [
        "/Users/EllaFerreira/mcp-file-assistant-workshop/file_assistant/server.py"
      ]
    }
  }
}

步骤5：重新启动克劳德桌面

• 彻底退出克劳德（Mac上的⌘Q）
• 再次打开
• 在窗口左下角查找设置图标

______________________________________________________________________

🎓 授课人

Ella Ferreira，布里斯班建造俱乐部城市负责人

• 软件工程师@Montu
• 5年全栈+AI集成经验

了解有关MCP的更多信息

• 📚 MCP官方文件
• 🐍 开发包
• 💬 社区 Discord
• 🎓 更多示例

内置于❤️ 布里斯班建筑俱乐部

编码愉快！ 👩🏻‍💻