mcpField
C
Claude MCP Protocol Practice

Claude MCP Protocol Practice

本地服务
github.com/harshal-14AI 与智能体082 周前更新

关于 Claude MCP Protocol Practice

这是面向初学者的 Claude MCP 协议练习项目,展示在 Windows 上启动天气 MCP 服务,以及配置 SQLite 服务处理面包店库存数据。

主要功能

  1. 01本地运行天气服务
  2. 02查询政府 API 的预警和天气预报
  3. 03配置 Claude Desktop 连接服务
  4. 04用 SQLite 示例管理面包店数据
  5. 05设置低库存查询

适用场景

  1. 01练习创建并启动 MCP 服务
  2. 02让 LLM 查询天气预警和预报
  3. 03通过 SQLite 示例探索食材库存
  4. 04配置 Claude Desktop 使用本地服务

MCP 相关

包含天气和 SQLite MCP 服务的搭建与配置示例,供 Claude Desktop 等 MCP 客户端连接。天气工具可从政府 API 获取预警和天气预报。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Claude MCP 协议实践

本仓库是 MIT Hack Decentralized AI 峰会的一次实践活动,介绍如何在 Windows 上用不到 5 分钟搭建并运行 Claude MCP 协议。

天气应用设置

前提条件
  • 确保已通过 pip 安装 uv
步骤
cd weather
uv run weather.py

这会在你的计算机上本地启动服务。Python 文件包含可供大模型使用的工具,用于从政府 API 获取预警和天气预报。

Claude 配置

确保已修改 Claude 桌面客户端中的 claude_config.json:

  1. 前往 File -> Settings -> Developer -> Edit Config
  2. 编辑配置部分,并提供 Python 文件的绝对路径

大功告成!你的第一个 MCP 服务已在 5 分钟内启动并运行。

示例配置文件
{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "<abs_path_to_file>/mcp-server-weather"]
    }
  }
}

面包店数据的 SQL-lite 数据库示例

将 SQL 数据库作为 MCP 服务运行的步骤
  1. 克隆仓库:

    git clone https://github.com/modelcontextprotocol/servers.git
    
  2. 进入 SQLite 目录:

    cd servers
    cd src
    cd sqlite
    
  3. 如有需要,请安装 Docker:

  4. 构建 Docker 镜像:

    docker build -t mcp/sqlite .
    
  5. 更新 Claude 配置文件:

    {
      "mcpServers": {
        "sqlite": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "-i",
            "-v",
            "mcp-test:/mcp",
            "mcp/sqlite",
            "--db-path",
            "/mcp/test.db"
          ]
        }
      }
    }
    
  6. 重启 Claude 以应用更改

面包店数据库设置
  1. 创建面包店数据库表:

    • ingredients(id、name、unit、quantity、cost、supplier、min_order_quantity)
  2. 填入以下数据:

    • 10 种带有 MOQ 的原料
  3. 添加以下查询:

    • 低库存预警

希望这些内容以后能对你有所帮助!

参考资料

MIT Hack 文档

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。