MCP Server 101

🚀 克莱德 MCP 协议实践

本仓库是 MIT 领先去中心化 AI 盛典练习环节的内容。它涵盖了在 Windows 系统下，5 分钟内启动并运行克莱德 MCP 协议的基本步骤，帮助你快速上手相关实践。

🚀 快速开始

✨ 主要特性

• 提供在 Windows 系统下快速启动克莱德 MCP 协议的方法。
• 包含天气应用和 SQL-lite 数据库示例，方便不同场景的实践。

📦 安装指南

天气应用设置

先决条件

⚠️ 重要提示

需确保已通过 pip 安装 uv 工具。

操作步骤

cd weather
uv run weather.py

此命令会在本地机器上启动一个服务器。该 Python 文件包含相关工具，可供 LLM 从政府 API 获取警报和预报信息。

克莱德配置设置

需在克莱德桌面更改 claude_config.json，具体步骤如下：

1. 导航到文件 -> 设置 -> 开发者 -> 编辑配置。
2. 编辑配置部分并提供 Python 文件的绝对路径。

完成上述操作后，第一个 MCP 服务器即可在 5 分钟内启动并运行。

示例配置文件

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "<abs_path_to_file>/mcp-server-weather"]
    }
  }
}

SQL-lite 数据库示例用于 Bakery 数据

运行 SQL 数据库作为 MCP 服务器的步骤

1. 克隆仓库：

   git clone https://github.com/modelcontextprotocol/servers.git
   

2. 切换到 SQLite 目录：

   cd servers
   cd src
   cd sqlite
   

3. 安装 Docker（如果需要）：
   • 遵循此链接中的说明：https://docs.docker.com/engine/install/
   • 根据文档验证其运行情况
4. 构建 Docker 镜像：

   docker build -t mcp/sqlite .
   

5. 更新克莱德配置文件：

   {
     "mcpServers": {
       "sqlite": {
         "command": "docker",
         "args": [
           "run",
           "--rm",
           "-i",
           "-v",
           "mcp-test:/mcp",
           "mcp/sqlite",
           "--db-path",
           "/mcp/test.db"
         ]
       }
     }
   }
   

6. 重启克莱德以应用更改。

Bakery 数据库设置

1. 创建 bakery 数据库表：
   • ingredients (id, name, unit, quantity, cost, supplier, min_order_quantity)
2. 填充数据：
   • 添加 10 种配料及其最小订货量（MOQs）
3. 添加查询以实现：
   • 库存低位警报

💻 使用示例

天气应用基础用法

cd weather
uv run weather.py

SQL-lite 数据库示例基础用法

git clone https://github.com/modelcontextprotocol/servers.git
cd servers
cd src
cd sqlite
docker build -t mcp/sqlite .

📚 详细文档

可参考以下资料获取更多信息： MIT 领先去中心化 AI 典的文档

📄 许可证

此仓库遵循 MIT 许可协议。