使用说明
🛠️ 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-workshop
2.安装依赖项
pip install mcp
3.查找您的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-server
2.安装MCP库
pip install mcp
3.写你的服务器 --创建 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.py
5.验证是否已添加
claude mcp list
6.在Claude代码中进行测试
claude
然后让克劳德使用你的工具。你也可以跑步 claude mcp get my-server 检查配置。
其他有用 claude mcp 命令
| 命令 | 它的作用 |
|---|---|
claude mcp add <name> <cmd> [args...] |
注册新服务器 |
claude mcp list |
列出所有已注册的服务器 |
claude mcp get <name> |
显示一台服务器的详细信息 |
claude mcp remove <name> |
删除服务器 |
范围： 默认情况下，服务器会保存到当前项目中(
.claude/settings.json).添加--scope user使服务器在所有项目中都可用。
claude mcp add --scope user my-server python /FULL/PATH/TO/server.py
资源
- MCP文件
- PyPI上的FastMCP
- 克劳德桌面下载
- 克劳德代码文档
- CBC不一致 ← 添加您的Discord链接
建造于
马里兰大学|克劳德建筑俱乐部
