AI导哈

MCP工具服务器

一个用于实现MCP工具服务器的快速教程，包含环境设置和代码实现。

  • by cmilcode
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cmilcode/simple-mcp-tool-lesson

使用说明

自述文件

此存储库包含我为一些同事制作的关于实现MCP工具服务器的快速课程的幻灯片和代码。

虽然幻灯片是由讲师解释的，但将其与本自述文件配对，应该可以让人们自己轻松完成这节课。

以下说明是截至2026年3月的最新说明，并在Lubuntu 24.04 VM上进行了测试。

环境设置

  1. 通过以下两种方式之一安装ollama：
    1. 对于执行以下操作的安装脚本 很多 对于本课中我不关心的额外随机内容，如创建服务、喷气背包、CUDA等，请运行安装脚本 curl -fsSL https://ollama.com/install.sh | sh
    2. 对于简单的手动安装，请运行 curl -fsSL https://ollama.com/download/ollama-linux-amd64.tar.zst \ | sudo tar x --zstd -C /usr 那就用吧 ollama serve 当你想经营OLAMA时。这将吃掉终端，所以在它自己的选项卡中运行它。
    3. 测试olama是否成功运行 ollama -v 在新选项卡中。
  2. 下拉一个你想使用的模型，它可以运行工具。在本演练中，我们将使用ministral-3。为什么？我喜欢牛角面包。
    1. ollama pull ministral-3
  3. 设置您的python环境。
    1. 如果您还没有安装python venv，请安装它 sudo apt install python3.12-venv
    2. 创建一个虚拟环境 python3 -m venv mcp_env
    3. 用以下方式激活您的venv source ./mcp_env/bin/activate
    4. 安装所需的软件包 pip install fastmcp ollama 获取最新的库，或使用requirements.txt获取本课程测试的冻结版本。
  4. 从cmilcode克隆仓库。
    1. git clone [this/repo]
  5. 更新中的LOGFILE变量。/tools/connectivitytest.sh指向易于访问的位置，以便您可以查看模型是如何执行脚本的。

编辑MCP服务器以添加我们的工具

  1. 编辑。/student_scripts/mcp_server_student.py与您最喜欢的文本编辑器
    1. vim ./student_scripts/mcp_server_STUDENT.py
  2. 您的工具实现应该放在指定的空间中，如下所示：
##########
########## STUDENT CODE STARTS HERE
##########

# Your code goes here.

##########
########## STUDENT CODE ENDS HERE
##########
  1. 如果遇到问题，可以在中找到将连接测试仪作为工具实现的一种方法。/答案/mcp_server_ANSWER.py。

执行MCP服务器并通过MCP客户端连接

  1. 首先，确保奥拉玛正在运行。
    1. 跑 ollama serve 如果你还没有。记住这会吃掉终端，所以在它自己的选项卡中运行它。
    2. 通过跑步确保OLAMA已启动且反应灵敏 ollama -v 在新选项卡中。
  2. 在我们的MCP环境中打开一个新终端并启动MCP服务器。
    1. ./mcp_env/bin/python ./student_scripts/mcp_server_STUDENT.py
  3. 在我们的MCP环境中打开一个新终端并启动MCP客户端。
    1. ./mcp_env/bin/python ./mcp_client_chatbot.py
  4. 请LLM执行需要您的工具来验证您的实现的任务之一。

相关 MCP