MCPort

MCPort 是一款本地优先的 MCP 工具，用于通过 AI 处理项目。它允许 AI 客户端读取代码、搜索文件、理解符号、检查 Git、编辑文件，并在获得明确授权时，在选定的 Workspace 内运行受控的开发命令。

默认情况下，项目文件、运行时状态和凭据都保留在你的机器上。你可以在本地使用 MCP，或通过公共互联网为选定的 Workspace 启用 OAuth/Bearer Token 访问。

中文说明：README.zh-CN.md

功能特性

• 读取和搜索项目文件、源代码、图片和目录

• 代码索引以及定义、引用、Hover 和文档符号支持

• Git 状态、差异、历史和 blame

• 受控的文件创建、编辑、导入、复制、移动和删除

• 文件更改的检查点、任务、验证和恢复

• 通过允许列表、超时、输出限制和本地确认实现受控命令执行

• 为一个或多个 Workspace 提供本地或公共 MCP 访问

• 按语言安装和更新 LSP，并支持自定义服务器

Related MCP server: Project Navigator MCP Server

连接 AI 客户端

在 MCPort 中，在 Projects 下添加项目，为 Workspace 启用 MCP，然后复制其连接信息。将复制的 MCP 地址添加到你的 AI 客户端的 MCP 设置中。对于公共访问，请使用 Workspace 的公共地址及其配置的 OAuth 或 Bearer Token 认证。

支持 MCP 的常见客户端包括 Claude Desktop、Cursor、Windsurf、Cline、Continue 以及其他兼容 MCP 的客户端。它们的设置位置和配置格式各不相同；请遵循客户端当前的 MCP 文档，并粘贴 MCPort 提供的地址或配置。

安装或更新 LSP 后，请让 AI 客户端再次调用 server_info，以便刷新可用的语言能力。

macOS 安装

当前的 macOS 版本未签名。将 MCPort.app 拖到 /Applications 后，运行：

xattr -dr com.apple.quarantine "/Applications/MCPort.app"

仅在验证 SHA256SUMS.txt 后，对官方下载执行此操作。

连接

本地访问默认接受回环请求。公共访问可以使用 Cloudflare Tunnel、TryCloudflare、FRP Client 或外部隧道，并采用 OAuth（推荐）或 Bearer Token 认证。

公共 Workspace 使用类似的路由：

https://mcp.example.com/w/<workspace>/mcp

文件、代码和 LSP

经过 realpath 和 symlink 检查后，文件操作仍保持在选定的 Workspace 内。内置代码索引支持 TypeScript、TSX、JavaScript、JSX、MJS 和 CJS。

语言服务器独立管理，可按需安装或更新。支持的语言包括 TypeScript/JavaScript、HTML、CSS/SCSS/LESS、Python、JSON、YAML、Markdown、Go、Rust、Java、C、C++ 和 PHP。可以为其他语言添加自定义 LSP 定义。

权限级别

• readonly：项目浏览、搜索、代码理解、只读 Git 和历史

• standard：文件更改、导入、检查点、任务和快速验证

• full：受控命令、命令会话、恢复和完整验证

命令使用可执行文件名加参数数组，绝不使用任意的 shell 字符串。它们仍受全局命令开关、精确允许列表、超时、输出限制和高风险确认的约束。

安全

在解析真实路径和符号链接后检查 Workspace 边界。文件更改支持 SHA256 基线、事务回滚和检查点。公共 Workspace 始终需要认证。令牌、隧道凭据和其他机密使用系统安全存储，并会在日志和跟踪中被脱敏处理。

Runtime 以当前登录的 OS 用户身份运行。命令允许列表不是操作系统沙箱。

文档

• 桌面指南

• AI 客户端指南

• MCP 工具

• LSP 指南

• 安全

• 公共网关和 OAuth

• 工具和权限

• 发布指南

贡献

MCPort 由 Sky 维护，并以 MIT License 发布。欢迎提交 Issue 和 Pull Request。请参阅 CONTRIBUTING.md、SECURITY.md、CODE_OF_CONDUCT.md、隐私说明 和 第三方声明。

第三方 LSP 从其各自的官方包管理器或发布渠道安装，不随 MCPort 捆绑。请遵守每个项目的许可证和条款。