使用说明

项目简介

MCP Link 是一个完整的框架,通过浏览器扩展和可选的本地服务器,使 AI 代理(如 ChatGPT, Claude 等)能够发现并安全地使用用户授权的工具,从而与现实世界进行交互。它提供了一种不依赖云服务商、用户掌握控制权的 AI 能力扩展方式。

主要功能点

  • 赋能 AI 使用工具: 允许 AI 代理发现并调用用户批准的本地或远程工具。
  • 安全执行工具: 支持用户控制工具的可见性和使用审批,包括自动允许或每次询问,并通过 Docker 等技术提供沙箱隔离。
  • 本地工具支持: 包含一个可选的 MCP 服务器,用于在用户自己的机器上安全地执行本地工具。
  • 透明的工具调用: 每次工具使用时,在浏览器中显示详细的调用请求和响应,方便用户审计和理解。
  • 模块化系统: 支持通过 Recipes 和 Plugins 系统集成新的 AI 网站和工具。

安装步骤

  1. 安装 MCP Link 浏览器扩展: 从 Chrome Web Store (即将上线) 或其他渠道安装 MCP Link 浏览器扩展。
  2. 访问受支持的 AI 网站: 前往如 ChatGPT, Claude 等兼容的 AI 聊天网站。
  3. (可选)设置本地 MCP 服务器: 扩展安装后会引导您设置本地 MCP 服务器(本仓库的 'server/' 部分),以便使用需要本地环境的工具。

服务器配置

MCP 服务器需要运行一个进程,MCP 客户端(如浏览器扩展)会配置如何启动或连接到这个服务器进程。对于 MCP Link 的本地服务器,客户端通常需要提供启动该 Python 服务器的命令和参数。

典型的客户端配置(例如在 MCP 客户端的设置中)会使用 JSON 格式,描述一个或多个 MCP 服务器连接。对于本地服务器,配置会包含如下信息:

[
  {
    "name": "用户自定义的服务器名称", // 服务器的显示名称
    "command": "用于启动服务器进程的可执行程序路径", // 例如:Python解释器的路径
    "args": ["服务器启动脚本路径", "其他启动参数..."] // 例如:指向 server/ 目录下的主启动脚本及其所需参数
    // 可能还会有其他配置项,如 "transport": "sse" 等
  }
  // 可以在此列表中添加更多 MCP 服务器配置
]

请注意: 上述 JSON 结构是 MCP 客户端通常需要的配置形式,它告诉客户端如何启动并连接到本地的 MCP Link 服务器进程。您不需要直接编辑代码,而是需要在 MCP 客户端(如浏览器扩展)的配置界面中填写这些信息。具体的 'command' 和 'args' 取决于您的系统环境以及 MCP Link 服务器的实际启动方式(通常由浏览器扩展辅助完成设置)。

基本使用方法

  1. 确保已安装浏览器扩展并访问受支持的 AI 网站。
  2. (如果需要本地工具)确保本地 MCP 服务器已按步骤设置并正在运行。
  3. 在 AI 聊天中提及需要特定工具的请求(例如,询问天气、发送消息等)。
  4. MCP Link 扩展会识别 AI 的请求,并根据您已启用的工具列表,允许 AI 调用相应的工具。
  5. 如果工具的使用策略设置为“每次询问”,会弹出窗口征求您的同意。
  6. 工具执行后,AI 会在聊天中收到工具的响应,并在浏览器中显示工具调用的详细信息。

信息

分类

桌面与硬件