上下文

一款美观、完全原生的 macOS 客户端，用于 Model Context 协议 (MCP)，使开发者能够与他们的 MCP 服务器交互并进行调试。

概述

Context 是一款原生 macOS 应用程序，可轻松测试和调试 MCP 服务器。它提供了一个可视化界面，用于调用工具、预览资源以及实时监控日志。该应用专为 MCP 服务器开发者打造，支持同时建立多个连接，并在开发过程中为您提供所需的调试可见性。

尽管当前的功能集已涵盖核心需求，但 Context 正在积极开发成为一个全面的 MCP 调试套件。未来的版本将包括对 MCP 规范更完整的支持、高级调试工具（如跟踪和代理），以及一个集成的聊天客户端，该客户端可以访问 MCP 服务器公开的所有功能。

功能

• 使用 Swift 和 SwiftUI 构建的原生 macOS 应用程序
• 可同时连接到多个 MCP 服务器
• 自动从 Cursor、Claude Code、Claude Desktop、Windsurf 和 VS Code 导入 MCP 服务器
• 基于 JSON Schema 自动生成工具调用界面
• 使用模板化参数动态生成提示
• 内置资源预览，支持语法高亮和 QuickLook
• 实时日志流，支持过滤和结构化日志查看
• 对 MCP 规范的全面支持（正在进行中）
• OAuth 支持动态客户端注册和元数据发现
• 支持 stdio 和 Streamable HTTP 传输协议（包括 HTTP+SSE 向后兼容）

截图

MCP 功能支持

支持的 MCP 协议版本： 2025-03-26

对 2025-06-18 版本的支持仍在开发中

功能	状态
传输协议
stdio	✅ 已支持
Streamable HTTP	✅ 已支持
HTTP+SSE	✅ 已支持
认证
OAuth 2.1 (IETF 草案)	✅ 已支持
OAuth 2.0 认证服务器元数据	✅ 已支持
OAuth 2.0 动态客户端注册	✅ 已支持
OAuth 2.0 受保护资源元数据	✅ 已支持
核心功能
Ping	✅ 已支持
提示	✅ 已支持
资源	✅ 已支持
工具	✅ 已支持
日志记录	✅ 已支持
高级功能
根节点	✅ 已支持
抽样	❌ 尚未支持
引导式对话	❌ 尚未支持
补全	✅ 已支持
分页	✅ 已支持
进度报告	❌ 尚未支持

项目结构

• Context/ - macOS 应用程序源代码
• ContextCore/ - 实现 MCP 客户端的 Swift 库，包括 stdio 和 Streamable HTTP 传输协议

安装

请从 GitHub 发布页面 下载最新版本。

系统要求： macOS 15.0 或更高版本

隐私与遥测

Context 使用 Sentry 进行崩溃报告和用户反馈收集，以帮助改进应用程序。如果您希望禁用遥测：

• 使用 SENTRY_DISABLED 预处理器标志编译应用程序
• GitHub 上的预编译版本默认启用 Sentry

贡献

我们热烈欢迎您的贡献和反馈！您可以：

• 🐛 在 GitHub 问题页面 提交关于 bug 或功能请求的问题
• 💬 通过应用内的 “提供反馈” 功能直接发送私人反馈
• 🔧 提交拉取请求以改进 Context

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

开发者

由 Indragie Karunaratne 创建

Context 快速上手指南

Context 是一款专为 macOS 设计的原生应用，旨在帮助开发者轻松测试、调试和交互模型上下文协议（MCP）服务器。它提供可视化界面来调用工具、预览资源并实时监控日志。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：macOS 15.0 (Sequoia) 或更高版本。
• 硬件架构：适用于 Apple Silicon (M1/M2/M3 等) 及 Intel Mac。
• 前置依赖：
  • 无需安装额外的命令行依赖（如 Node.js 或 Python），应用为独立二进制文件。
  • 您需要至少一个正在运行或可配置的 MCP Server（例如通过 Cursor, Claude Desktop, VS Code 等配置的服务）。

安装步骤

目前该项目主要通过 GitHub Releases 分发，请按照以下步骤安装：

1. 下载最新版本 访问项目的 GitHub Releases 页面，下载适用于 macOS 的最新 .dmg 安装包（通常命名为 Context-x.x.x.dmg）。

   注意：目前暂无官方提供的中国镜像源，请直接通过 GitHub 下载。如果下载速度较慢，建议使用网络加速工具或代理。

2. 安装应用

   • 双击下载的 .dmg 文件。
   • 将 Context 图标拖拽至 Applications 文件夹中。

3. 首次运行权限设置

   • 在“启动台”或“应用程序”文件夹中找到 Context 并点击打开。
   • 由于是未签名的第三方应用（或来自非 App Store），macOS 可能会拦截启动。请前往 系统设置 (System Settings) > 隐私与安全性 (Privacy & Security)，在底部找到关于 Context 被阻止的提示，点击 仍要打开 (Open Anyway)。

基本使用

安装完成后，您可以按照以下流程快速连接并调试您的 MCP 服务器：

1. 自动导入现有配置

Context 支持自动检测并导入主流编辑器中已配置的 MCP 服务器。

• 启动 Context。
• 应用会自动扫描并列出来自 Cursor, Claude Code, Claude Desktop, Windsurf, 和 VS Code 的 MCP 配置。
• 在侧边栏选择任意一个已识别的服务器即可建立连接。

2. 手动添加服务器

如果您的服务器未自动发现，可以手动添加：

• 点击左上角的 + 号或 Add Server。
• 选择传输协议类型（支持 stdio 或 Streamable HTTP）。
• 输入相应的命令参数（例如 stdio 模式下的启动命令和参数）或 HTTP 端点地址。
• 点击 Connect。

3. 核心功能操作

连接成功后，您可以通过以下标签页进行调试：

• Tools (工具):

  • 查看服务器暴露的所有工具列表。
  • 界面会根据 JSON Schema 自动生成输入表单。填写参数后点击 Invoke 即可执行工具并查看返回结果。

• Prompts (提示词):

  • 浏览可用的提示词模板。
  • 动态生成基于参数的提示词内容，方便测试不同变量下的输出效果。

• Resources (资源):

  • 预览服务器提供的资源文件。
  • 支持语法高亮显示，并可利用 macOS 原生的 QuickLook 功能快速预览文件内容。

• Logs (日志):

  • 实时流式查看 MCP 通信日志。
  • 支持按级别过滤日志，并以结构化格式查看请求与响应详情，便于排查错误。

4. 多服务器并发调试

您可以同时连接多个 MCP 服务器。在左侧边栏勾选多个服务，即可在同一个会话中对比不同服务器的行为或测试它们之间的互操作性。