模型上下文协议服务

MCP是一个用于创建和管理模型上下文协议服务器的工具,支持快速开发和调试。

  • by irobust
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 irobust/MCP-Workshop

使用说明

模型上下文协议(MCP)

使用第三方MCP服务器

  • https://github.com/modelcontextprotocol/servers
  • https://github.com/mcp
  • https://mcp.so/
  • https://www.pulsemcp.com/

使用时间MCP服务器

  1. 转到“设置”
  2. 选择 Developer
  3. 编辑配置
  4. 添加MCP服务器
    {
    "mcpServers": {
        "time": {
        "command": "uvx",
        "args": ["-q","mcp-server-time","--local-timezone=America/New_York"]
        }
    }
    }
    

创建MCP服务器

  1. 安装UV

    $ pip install uv
    
  2. 初始化项目

    $ uv init hello
    
  3. 创建虚拟环境

    $ cd hello
    $ uv venv
    
  4. 激活虚拟环境

    $ source .venv/bin/activate
    

    或Windows

    > .venv\Scripts\activate
    
  5. 安装FastMCP

    $ uv add fastmcp
    
  6. 创建MCP服务器(server.py)

    from fastmcp import FastMCP
    
    mcp = FastMCP("Hello MCP Server")
    
    @mcp.tool
    def say_hello(name: str) -> str:
        return f"Hello, {name}!"
    
    if __name__ == "__main__":
        print("🚀 Starting MCP server at http://localhost:8000/mcp")
        mcp.run(transport="http", port=8000)
    
  7. 在开发模式下运行Hello

    $ fastmcp dev server.py
    
  8. 将配置添加到Clude开发人员设置

    "hello": {
        "command": "/opt/homebrew/bin/uv",
        "args": [
            "--directory",
            "/Users/phanupong/Documents/Workshop/hello",
            "run",
            "server.py"
        ]
    }
    

调试MCP服务器

  1. MCP检查员

  2. Claude桌面调试

    • 单击连接图标查看
      1. 已连接的服务器
      2. 可用提示和资源
    • 发生错误时单击查看MCP服务器日志
  3. 使用Chrome开发工具

    • 添加 allowDevTools 到开发人员设置
      { "allowedDevTools" : true }
      
    • 打开DevTools: Command + Option + Shift + i

无虚拟环境运行

  1. 将目录更改为 hello 文件夹
  2. 运行npx以启动MCP检查器
    $ npx @modelcontextprotocol/inspector uv run server.py
    
    在MacOs上,您需要先安装检查器
    $ npm i @modelcontextprotocol/inspector