快速入门

MCP 是一个协议，它可以在 host 应用（如 Claude Desktop）和本地服务之间建立安全连接。在本快速入门指南中，你将学习如何：

• 设置本地 SQLite 数据库
• 通过 MCP 将 Claude Desktop 连接到该数据库
• 安全地查询和分析你的数据

​

MCP 如何工作

MCP (Model Context Protocol) 是一个开放协议，它可以在 AI 应用程序与本地或远程资源之间实现安全、受控的交互。让我们来解析一下它的工作原理，然后看看我们将在本指南中如何使用它。

​

通用架构

MCP 的核心是一个 client-server 架构，host 应用程序可以连接到多个服务器：

• MCP Hosts: 像 Claude Desktop、IDEs 或 AI 工具这样的程序，它们希望通过 MCP 访问资源
• MCP Clients: 维护与服务器 1:1 连接的协议客户端
• MCP Servers: 轻量级程序，通过标准化的 Model Context Protocol 暴露特定功能
• Local Resources: 你的计算机资源（数据库、文件、服务），MCP 服务器可以安全地访问这些资源
• Remote Resources: 通过互联网可用的资源（例如，通过 APIs），MCP 服务器可以连接到这些资源

​

在本指南中

对于本快速入门，我们将使用 SQLite 实现一个集中示例：

1. Claude Desktop 作为我们的 MCP 客户端
2. 一个 SQLite MCP 服务器提供安全的数据库访问
3. 你的本地 SQLite 数据库存储实际数据

SQLite MCP 服务器和你的本地 SQLite 数据库之间的通信完全发生在你的机器上 — 你的 SQLite 数据库不会暴露在互联网上。Model Context Protocol 确保 Claude Desktop 只能通过定义良好的接口执行批准的数据库操作。这为你提供了一种安全的方式，让 Claude 分析和交互你的本地数据，同时完全控制它可以访问的内容。

​

前提条件

• macOS 或 Windows
• 安装最新版本的 Claude Desktop
• uv 0.4.18 或更高版本（uv --version 检查）
• Git（git --version 检查）
• SQLite（sqlite3 --version 检查）

# 使用 Homebrew
brew install uv git sqlite3

# 或直接下载：
# uv: https://docs.astral.sh/uv/
# Git: https://git-scm.com
# SQLite: https://www.sqlite.org/download.html

# 使用 winget
winget install --id=astral-sh.uv -e
winget install git.git sqlite.sqlite

# 或直接下载：
# uv: https://docs.astral.sh/uv/
# Git: https://git-scm.com
# SQLite: https://www.sqlite.org/download.html

​

安装

# 创建一个新的 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

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "/Users/YOUR_USERNAME/test.db"]
    }
  }
}

​

测试

让我们验证一切正常。尝试向 Claude Desktop 发送以下提示：

你能连接到我的 SQLite 数据库并告诉我有哪些产品及其价格吗？

Claude Desktop 将会：

1. 连接到 SQLite MCP 服务器
2. 查询你的本地数据库
3. 格式化并展示结果

​

背后发生了什么？

当你使用 MCP 与 Claude Desktop 交互时：

1. 服务器发现：Claude Desktop 在启动时连接到你配置的 MCP 服务器

2. 协议握手：当你询问数据时，Claude Desktop：

   • 确定哪个 MCP 服务器可以提供帮助（在本例中是 sqlite）
   • 通过协议协商能力
   • 从 MCP 服务器请求数据或操作

3. 交互流程：

4. 安全性：

   • MCP 服务器仅暴露特定、受控的功能
   • MCP 服务器在你的机器上本地运行，它们访问的资源不会暴露在互联网上
   • Claude Desktop 需要用户确认以进行敏感操作

​

尝试这些示例

现在 MCP 正常工作，尝试这些越来越强大的示例：

数据库中所有产品的平均价格是多少？

你能分析价格分布并建议任何定价优化吗？

你能帮我设计并创建一个新表来存储客户订单吗？

​

添加更多功能

想给 Claude Desktop 更多本地集成功能？将这些服务器添加到你的配置中：

"filesystem": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/YOUR_USERNAME/Desktop"]
}

"postgres": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
}

​

更多 MCP 客户端

虽然本指南演示了使用 Claude Desktop 作为客户端的 MCP，但还有其他支持 MCP 集成的应用程序：

每个主机应用程序可能以不同的方式实现 MCP 功能或支持不同的功能。请查看它们各自的文档以获取特定的设置说明和支持的功能。

​

故障排除

​

下一步