自述文件
此存储库包含我为一些同事制作的关于实现MCP工具服务器的快速课程的幻灯片和代码。
虽然幻灯片是由讲师解释的,但将其与本自述文件配对,应该可以让人们自己轻松完成这节课。
以下说明是截至2026年3月的最新说明,并在Lubuntu 24.04 VM上进行了测试。
环境设置
- 通过以下两种方式之一安装ollama:
1. 对于执行以下操作的安装脚本 *很多* 对于本课中我不关心的额外随机内容,如创建服务、喷气背包、CUDA等,请运行安装脚本 curl -fsSL https://ollama.com/install.sh | sh 1. 对于简单的手动安装,请运行 curl -fsSL https://ollama.com/download/ollama-linux-amd64.tar.zst \ | sudo tar x --zstd -C /usr 那就用吧 ollama serve 当你想经营OLAMA时。这将吃掉终端,所以在它自己的选项卡中运行它。 1. 测试olama是否成功运行 ollama -v 在新选项卡中。
- 下拉一个你想使用的模型,它可以运行工具。在本演练中,我们将使用ministral-3。为什么?我喜欢牛角面包。
1. ollama pull ministral-3
- 设置您的python环境。
1. 如果您还没有安装python venv,请安装它 sudo apt install python3.12-venv 1. 创建一个虚拟环境 python3 -m venv mcp_env 1. 用以下方式激活您的venv source ./mcp_env/bin/activate 1. 安装所需的软件包 pip install fastmcp ollama 获取最新的库,或使用requirements.txt获取本课程测试的冻结版本。
- 从cmilcode克隆仓库。
1. git clone [this/repo]
- 更新中的LOGFILE变量。/tools/connectivitytest.sh指向易于访问的位置,以便您可以查看模型是如何执行脚本的。
编辑MCP服务器以添加我们的工具
- 编辑。/student_scripts/mcp_server_student.py与您最喜欢的文本编辑器
1. vim ./student_scripts/mcp_server_STUDENT.py
- 您的工具实现应该放在指定的空间中,如下所示:
##########
########## STUDENT CODE STARTS HERE
##########
# Your code goes here.
##########
########## STUDENT CODE ENDS HERE
##########- 如果遇到问题,可以在中找到将连接测试仪作为工具实现的一种方法。/答案/mcp_server_ANSWER.py。
执行MCP服务器并通过MCP客户端连接
- 首先,确保奥拉玛正在运行。
1. 跑 ollama serve 如果你还没有。记住这会吃掉终端,所以在它自己的选项卡中运行它。 1. 通过跑步确保OLAMA已启动且反应灵敏 ollama -v 在新选项卡中。
- 在我们的MCP环境中打开一个新终端并启动MCP服务器。
1. ./mcp_env/bin/python ./student_scripts/mcp_server_STUDENT.py
- 在我们的MCP环境中打开一个新终端并启动MCP客户端。
1. ./mcp_env/bin/python ./mcp_client_chatbot.py
- 请LLM执行需要您的工具来验证您的实现的任务之一。
