Skip to main content
Glama

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: Coding Tools MCP

连接 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 用户身份运行。命令允许列表不是操作系统沙箱。

文档

贡献

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

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides AI clients with safe, structured access to local filesystem, Git repositories, and project contexts, featuring file operations, git status/diff, project management, and built-in code review/bug analysis prompts.
    1,927 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to develop within a local project workspace by reading and modifying files, running commands and tests, checking Git state, and persisting progress as history sessions that can be restored in later conversations.
    Apache 2.0
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI clients like ChatGPT or Codex to manage files and local Git repositories within an explicitly authorized workspace, with server-enforced path boundary checks and optional remote Git operations.
    18
    1
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables coding agents to safely inspect and modify project files within explicitly allowed workspace roots, with controls for file operations, git status/diff, and optionally allowlisted command execution.
    11
    Apache 2.0