MCPort

MCPort es una herramienta MCP local-first para trabajar con proyectos a través de IA. Permite que un cliente de IA lea código, busque archivos, comprenda símbolos, inspeccione Git, edite archivos y—cuando se autoriza explícitamente—ejecute comandos de desarrollo controlados dentro de Workspaces seleccionados.

Los archivos del proyecto, el estado en tiempo de ejecución y las credenciales permanecen en tu máquina de forma predeterminada. Puedes usar MCP localmente o habilitar el acceso OAuth/Bearer Token para Workspaces seleccionados a través de internet público.

Descripción en chino: README.zh-CN.md

Features

• Leer y buscar archivos de proyecto, código fuente, imágenes y directorios

• Indexación de código además de soporte para definición, referencia, Hover y símbolos de documento

• Estado de Git, diffs, historial y blame

• Creación, edición, importación, copia, movimiento y eliminación de archivos contenidos

• Checkpoints, tareas, validación y recuperación para cambios de archivos

• Ejecución de comandos controlada con listas permitidas, timeouts, límites de salida y confirmación local

• Acceso MCP local o público para uno o más Workspaces

• Instalación y actualizaciones de LSP por idioma, con soporte para servidores personalizados

Related MCP server: Project Navigator MCP Server

Connect an AI client

En MCPort, añade un proyecto en Projects, habilita MCP para el Workspace y luego copia su información de conexión. Añade la dirección MCP copiada a la configuración MCP de tu cliente de IA. Para acceso público, usa la dirección pública del Workspace y su autenticación OAuth o Bearer Token configurada.

Los clientes comunes que soportan MCP incluyen Claude Desktop, Cursor, Windsurf, Cline, Continue y otros clientes compatibles con MCP. Sus ubicaciones de configuración y formatos varían; sigue la documentación MCP actual del cliente y pega la dirección o configuración proporcionada por MCPort.

Después de instalar o actualizar un LSP, pide al cliente de IA que llame a server_info de nuevo para que pueda actualizar las capacidades de idioma disponibles.

macOS installation

La versión actual de macOS no está firmada. Después de arrastrar MCPort.app a /Applications, ejecuta:

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

Haz esto solo para la descarga oficial después de verificar SHA256SUMS.txt.

Connections

El acceso local acepta solicitudes de loopback de forma predeterminada. El acceso público puede usar Cloudflare Tunnel, TryCloudflare, FRP Client o un túnel externo, con autenticación OAuth (recomendada) o Bearer Token.

Los Workspaces públicos usan rutas como:

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

Files, code, and LSP

Las operaciones de archivos permanecen dentro del Workspace seleccionado después de comprobaciones de realpath y symlink. El índice de código integrado soporta TypeScript, TSX, JavaScript, JSX, MJS y CJS.

Los servidores de idioma se gestionan de forma independiente y pueden instalarse o actualizarse bajo demanda. Los idiomas soportados incluyen TypeScript/JavaScript, HTML, CSS/SCSS/LESS, Python, JSON, YAML, Markdown, Go, Rust, Java, C, C++ y PHP. Se pueden añadir definiciones LSP personalizadas para otros idiomas.

Permission tiers

• readonly: navegación de proyectos, búsqueda, comprensión de código, Git de solo lectura e historial

• standard: cambios de archivos, importaciones, checkpoints, tareas y validación rápida

• full: comandos controlados, sesiones de comandos, recuperación y validación completa

Los comandos usan un nombre de ejecutable más una matriz de argumentos, nunca una cadena de shell arbitraria. Siguen sujetos al interruptor global de comandos, la lista permitida exacta, los timeouts, los límites de salida y la confirmación de alto riesgo.

Security

Los límites del Workspace se comprueban después de resolver rutas reales y symlinks. Los cambios de archivos soportan líneas base SHA256, reversión transaccional y checkpoints. Los Workspaces públicos siempre requieren autenticación. Los tokens, credenciales de túnel y otros secretos usan almacenamiento seguro del sistema y se redactan de registros y trazas.

El Runtime se ejecuta como el usuario del sistema operativo con sesión iniciada. La lista permitida de comandos no es un sandbox del sistema operativo.

Documentation

• Desktop guide

• AI client guide

• MCP tools

• LSP guide

• Security

• Public gateway and OAuth

• Tools and permissions

• Release guide

Contributing

MCPort es mantenido por Sky y se publica bajo la Licencia MIT. Se aceptan issues y pull requests. Consulta CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, notas de privacidad y avisos de terceros.

Los LSP de terceros se instalan desde sus propios gestores de paquetes oficiales o canales de lanzamiento y no se incluyen con MCPort. Sigue la licencia y los términos de cada proyecto.