🛠️ CBC x理念——MCP工作坊
UMD克劳德建筑俱乐部|2026年3月27日
欢迎此仓库包含MCP Workshop的所有内容。\ 实时跟进,或在会议结束后在家中设置。
______________________________________________________________________
这里有什么
| 文件 | 它是什么 |
|---|---|
server.py | 我们共同构建的完整MCP服务器 |
workshop.ipynb | 谷歌Colab笔记本电脑——无需任何设置即可运行这些工具 |
claude_desktop_config.json | 用于连接到Claude Desktop的模板配置 |
requirements.txt | Python依赖关系 |
______________________________________________________________________
选项A——在Google Colab中跟随(无需设置)
只需打开它,单击 运行时→ 全部运行,你很好。
______________________________________________________________________
选项B--在本地运行完整的MCP服务器
先决条件
- Python 3.10+
- 克劳德桌面(免费): claude.ai/下载
步骤
1.克隆此仓库
git clone https://github.com/YOUR_USERNAME/umd-mcp-workshop.git
cd umd-mcp-workshop2.安装依赖项
pip install mcp3.查找您的Claude Desktop配置文件
| 操作系统 | 路径 |
|---|---|
| Mac | ~/Library/Application Support/Claude/claude_desktop_config.json |
| 窗户 | %APPDATA%\Claude\claude_desktop_config.json |
4.将此添加到您的配置中 (用实际路径替换路径)
{
"mcpServers": {
"umd-survival": {
"command": "python",
"args": ["/FULL/PATH/TO/umd-mcp-workshop/server.py"]
}
}
}5.重新启动克劳德桌面
你会看到一个🔨 聊天框中的锤子图标——这意味着您的工具已连接。
6.试试看
"Hey Claude, I have a segmentation fault and I don't know why"
"Hey Claude, my project is 20% done with 2 days left and I slept 3 hours"______________________________________________________________________
任何MCP服务器的三步结构
from mcp.server.fastmcp import FastMCP
# Step 1: Create the server
mcp = FastMCP("My Server")
# Step 2: Decorate functions with @mcp.tool()
@mcp.tool()
def my_tool(input: str) -> str:
"""Claude reads this docstring to know what the tool does."""
return f"You said: {input}"
# Step 3: Run it
mcp.run()这就是整个协议。其他一切都只是Python。
______________________________________________________________________
选项C——构建自己的MCP服务器并将其添加到Claude代码中
想走得更远吗?以下是如何创建一个全新的服务器并将其连接到Claude Code(CLI)。
先决条件
- 已安装克劳德代码:
npm install -g @anthropic-ai/claude-code - Python 3.10+
步骤
1.创建新的项目文件夹
mkdir my-mcp-server
cd my-mcp-server2.安装MCP库
pip install mcp3.写你的服务器 --创建 server.py:
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("my-server")
@mcp.tool()
def hello(name: str) -> str:
"""Say hello to someone."""
return f"Hello, {name}!"
mcp.run()4.将服务器添加到Claude Code
从任何地方运行此命令(用实际路径替换路径):
claude mcp add my-server python /FULL/PATH/TO/my-mcp-server/server.py要使用虚拟环境的Python:
claude mcp add my-server /path/to/venv/bin/python /FULL/PATH/TO/server.py5.验证是否已添加
claude mcp list6.在Claude代码中进行测试
claude然后让克劳德使用你的工具。你也可以跑步 claude mcp get my-server 检查配置。
其他有用 claude mcp 命令
| 命令 | 它的作用 |
|---|---|
claude mcp add [args...] | 注册新服务器 |
claude mcp list | 列出所有已注册的服务器 |
claude mcp get | 显示一台服务器的详细信息 |
claude mcp remove | 删除服务器 |
范围: 默认情况下,服务器会保存到当前项目中(.claude/settings.json).添加--scope user使服务器在所有项目中都可用。
claude mcp add --scope user my-server python /FULL/PATH/TO/server.py______________________________________________________________________
资源
- MCP文件
- PyPI上的FastMCP
- 克劳德桌面下载
- 克劳德代码文档
- CBC不一致 ← 添加您的Discord链接
建造于
马里兰大学|克劳德建筑俱乐部
