使用 MCP 资源

资源类型、访问方式与安全实践

概述

MCP 资源是服务器提供的数据源,例如数据库表、文件系统、API 端点或配置项。通过资源访问能力,Claude Code 能够在受控权限下读取、写入和管理外部数据。

资源类型

  • 数据库表与视图
  • 文件系统目录与文件
  • HTTP API 端点
  • 配置与密钥存储
  • 监控与日志数据

发现与访问

/mcp

# 输出示例
MCP 资源:
- database://users: 用户表
- database://orders: 订单表
- filesystem://logs: 日志目录
- api://metrics: 监控 API
# 访问数据库资源
查询用户表中的活跃用户

# 访问文件系统资源
读取日志目录中的最新日志

# 访问 API 资源
调用用户 API 获取用户详情

资源查询与过滤

# 查询资源
查询用户表中所有活跃用户

# 使用过滤条件
查询用户表中年龄大于 18 的用户

# 限制结果数量
查询用户表的前 100 条记录

资源操作

# 读取资源
读取用户表的前 10 条记录

# 写入资源
向用户表插入新用户

# 更新资源
更新用户表中 ID 123 的信息

# 删除资源
删除用户表中 ID 123 的用户

资源元数据与统计

# 查看资源信息
显示用户表的详细信息
# 输出示例
资源:database://users
类型:数据库表
列:
- id: INTEGER, PRIMARY KEY
- name: VARCHAR(255)
- email: VARCHAR(255)
# 查看资源统计
显示用户表的统计信息

权限与缓存

# 检查访问权限
检查用户表的访问权限

# 请求额外权限
请求用户表的删除权限
# 启用资源缓存
启用用户表缓存

# 清除资源缓存
清除用户表缓存

监控与安全

# 查看资源使用统计
显示资源使用统计

# 查看资源性能指标
显示资源性能指标
# 加密敏感数据
加密用户表中的密码字段

# 查看访问日志
显示用户表的访问日志

最佳实践

  • 仅查询必要字段,控制结果规模
  • 针对热点资源开启缓存并定期刷新
  • 为敏感资源配置最小权限策略
  • 定期审计访问日志与资源使用情况

故障排除

# 资源不可用
/mcp
# 检查资源是否存在

# 权限不足
检查资源访问权限

# 性能问题
显示资源性能指标

On this page