在了解了 MCP 的一些基础知识后,接下来我们将通过一个简单的示例来演示如何使用 MCP 协议。这里我们以 一个 SQLite MCP 服务器 为例进行说明。
这里的 SQLite MCP 服务器和本地 SQLite 数据库之间的通信完全在您的计算机上 — 您的 SQLite 数据库不会暴露在互联网上。MCP 协议确保 Claude Desktop 只能通过明确定义的接口执行批准的数据库操作。这为您提供了一种安全的方式让 Claude 分析你的本地数据并与之交互,同时保持对其可以访问的内容的完全控制。
准备工作
在开始之前,请确保你的系统已经安装了以下必备组件:
- macOS 或 Windows 操作系统
- 最新版本的 Cursor
- uv 0.4.18 或更高版本 (使用 uv --version 检查)
- Git (git --version 检查)
- SQLite (sqlite3 --version 检查)
对于 macOS 用户,可以使用 Homebrew 安装这些组件:
# Using Homebrew brew install uv git sqlite3 # 或者直接下载: # uv: https://docs.astral.sh/uv/ # Git: https://git-scm.com # SQLite: https://www.sqlite.org/download.html
而对于 Windows 用户,可以使用 winget 安装这些组件:
# 使用 winget 安装 winget install --id=astral-sh.uv -e winget install git.git sqlite.sqlite # Or download directly: # uv: https://docs.astral.sh/uv/ # Git: https://git-scm.com # SQLite: https://www.sqlite.org/download.html
安装
接下来我们会以 macOS 为例进行说明,Windows 用户可以参考 macOS 的安装步骤。
首先我们来创建一个简单的 SQLite 数据库,并插入一些数据:
# 创建一个新的 SQLite 数据库 sqlite3 ~/test.db <<EOF CREATE TABLE products ( id INTEGER PRIMARY KEY, name TEXT, price REAL ); INSERT INTO products (name, price) VALUES ('Widget', 19.99), ('Gadget', 29.99), ('Gizmo', 39.99), ('Smart Watch', 199.99), ('Wireless Earbuds', 89.99), ('Portable Charger', 24.99), ('Bluetooth Speaker', 79.99), ('Phone Stand', 15.99), ('Laptop Sleeve', 34.99), ('Mini Drone', 299.99), ('LED Desk Lamp', 45.99), ('Keyboard', 129.99), ('Mouse Pad', 12.99), ('USB Hub', 49.99), ('Webcam', 69.99), ('Screen Protector', 9.99), ('Travel Adapter', 27.99), ('Gaming Headset', 159.99), ('Fitness Tracker', 119.99), ('Portable SSD', 179.99); EOF
然后打开任意 Cursor 项目,在项目根目录下面创建 .cursor/mcp.json
文件,然后添加以下配置:
{ "mcpServers": { "sqlite": { "command": "uvx", "args": [ "mcp-server-sqlite", "--db-path", "/Users/YOUR_USERNAME/test.db" ] } } }
需要将 YOUR_USERNAME
替换为你的实际用户名。上面的配置文件表示我们定义了名为 sqlite 的 MCP 服务器,并指定使用 uvx
命令来启动该服务器,在 args
参数里面指定了 MCP 服务器以及实际的数据库路径为 /Users/YOUR_USERNAME/test.db
。
保存上面的配置后,然后就可以在 Cursor 设置中的 MCP 标签下面查看到我们配置的 MCP 服务器了。
使用
从上图可用看到我们可以进行很多操作,比如查询数据库中的数据,创建新的数据,更新数据,删除数据等。
比如我们发送如下所示的需求,注意需要选择 Agent
模式:
请告诉我 sqlite 数据库中有哪些产品以及价格
然后 Cursor 就会根据我们的需求语义分析去查询我们的 SQLite 数据库,并将结果返回给我们,如下图所示:
这样我们就轻松完成了一个 MCP 服务器的简单使用,接下来我们会和大家来详细讲解如何开发自己的 MCP 服务器。