MCPort

MCPort — это локальный инструмент MCP для работы с проектами через ИИ. Он позволяет ИИ-клиенту читать код, искать файлы, понимать символы, просматривать Git, редактировать файлы и — при явном разрешении — выполнять контролируемые команды разработки внутри выбранных Workspace.

Файлы проекта, состояние выполнения и учётные данные по умолчанию остаются на вашем компьютере. Вы можете использовать MCP локально или включить доступ через OAuth/Bearer Token для выбранных Workspace через публичный интернет.

Китайская версия: README.zh-CN.md

Возможности

• Чтение и поиск файлов проекта, исходного кода, изображений и каталогов

• Индексация кода, а также поддержка определений, ссылок, Hover и символов документа

• Статус Git, диффы, история и blame

• Ограниченное создание, редактирование, импорт, копирование, перемещение и удаление файлов

• Контрольные точки, задачи, проверка и восстановление изменений файлов

• Контролируемое выполнение команд со списками разрешений, тайм-аутами, ограничениями вывода и локальным подтверждением

• Локальный или публичный доступ MCP к одному или нескольким Workspace

• Установка и обновление LSP для каждого языка с поддержкой пользовательских серверов

Related MCP server: Project Navigator MCP Server

Подключение ИИ-клиента

В MCPort добавьте проект в разделе Projects, включите MCP для Workspace и скопируйте его данные подключения. Добавьте скопированный адрес MCP в настройки MCP вашего ИИ-клиента. Для публичного доступа используйте публичный адрес Workspace и настроенную аутентификацию OAuth или Bearer Token.

К распространённым клиентам, поддерживающим MCP, относятся Claude Desktop, Cursor, Windsurf, Cline, Continue и другие MCP-совместимые клиенты. Расположение их настроек и формат конфигурации различаются; следуйте актуальной документации MCP вашего клиента и вставьте адрес или конфигурацию, предоставленные MCPort.

После установки или обновления LSP попросите ИИ-клиент снова вызвать server_info, чтобы он обновил доступные языковые возможности.

Установка на macOS

Текущий выпуск для macOS не подписан. После перетаскивания MCPort.app в /Applications выполните:

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

Делайте это только для официальной загрузки после проверки SHA256SUMS.txt.

Подключения

Локальный доступ по умолчанию принимает запросы с loopback. Публичный доступ может использовать Cloudflare Tunnel, TryCloudflare, FRP Client или внешний туннель с аутентификацией OAuth (рекомендуется) или Bearer Token.

Публичные Workspace используют маршруты вида:

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

Файлы, код и LSP

Операции с файлами остаются внутри выбранного Workspace после проверки realpath и символических ссылок. Встроенный индекс кода поддерживает 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: контролируемые команды, командные сессии, восстановление и полная проверка

Команды используют имя исполняемого файла плюс массив аргументов, а не произвольную строку оболочки. Они по-прежнему подчиняются глобальному переключателю команд, точному списку разрешений, тайм-аутам, ограничениям вывода и подтверждению высокорисковых операций.

Безопасность

Границы Workspace проверяются после разрешения реальных путей и символических ссылок. Изменения файлов поддерживают базовые значения SHA256, транзакционный откат и контрольные точки. Публичные Workspace всегда требуют аутентификации. Токены, учётные данные туннеля и другие секреты хранятся в защищённом системном хранилище и скрываются из журналов и трассировок.

Runtime выполняется от имени вошедшего в систему пользователя ОС. Список разрешений команд не является песочницей операционной системы.

Документация

• Руководство по настольному приложению

• Руководство для ИИ-клиента

• Инструменты MCP

• Руководство по LSP

• Безопасность

• Публичный шлюз и OAuth

• Инструменты и разрешения

• Руководство по выпуску

Участие

MCPort поддерживается Sky и распространяется под лицензией MIT. Приветствуются вопросы и pull request. См. CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, заметки о конфиденциальности и уведомления о сторонних компонентах.

Сторонние LSP устанавливаются из их собственных официальных менеджеров пакетов или каналов выпуска и не входят в состав MCPort. Соблюдайте лицензию и условия каждого проекта.