Implementación de TypeScript del protocolo de contexto de modelo

Descripción general

Este proyecto implementa el Protocolo de Contexto Modelo (MCP) como una encarnación práctica del Marco de Inteligencia Personal (PIF). Mediante herramientas estructuradas y patrones de interacción progresivos, crea espacios para el desarrollo significativo de la comprensión entre humanos e IA.

Inicio rápido

Prerrequisitos

• Node.js 18+ y npm
• TypeScript 5.0+
• SDK de TypeScript del protocolo de contexto de modelo
• Cliente de escritorio Claude configurado para servidores personalizados

Nota : Esta implementación se ha probado en sistemas Windows y macOS/Linux.

Configuración

1. Clonar el repositorio:

2. Instalar dependencias:

3. Configurar el servidor:
   • La configuración ahora se detecta automáticamente de forma predeterminada, pero puedes personalizarla:
     • Establezca la variable de entorno MCP_WORKSPACE_ROOT para especificar una ubicación del espacio de trabajo
     • O configure la variable de entorno MCP_CONFIG con una cadena JSON de opciones de configuración
     • O edite directamente src/config.ts para modificar la configuración predeterminada
4. Construir el servidor:

5. Configurar el cliente de escritorio Claude:
   • Localice el directorio de configuración de su cliente de escritorio Claude
   • Cree o modifique claude_desktop_config.json :
     { "mcpServers": { "mcp-pif": { "command": "node", "args": ["path/to/your/mcp-pif/build/index.js"], "cwd": "path/to/your/mcp-pif", "env": {} } } }
   • Reemplace path/to/your/mcp-pif con su ruta de repositorio actual
   • Las rutas se normalizan automáticamente para su sistema operativo
6. Conectar el cliente de escritorio de Claude:
   • Inicie o reinicie el cliente de escritorio Claude
   • Seleccione "mcp-pif" como su servidor personalizado
   • Inicie un nuevo chat para comenzar a utilizar el servidor

Estructura del directorio

El servidor creará y administrará la siguiente estructura en su espacio de trabajo configurado:

Próximos pasos

• Revise la documentación del módulo para conocer las herramientas disponibles
• Explora la Guía de arquitectura para obtener detalles de implementación
• Consulte la Guía de desarrollo para conocer las pautas de contribución.

Solución de problemas

• Si especifica rutas manualmente, utilice separadores apropiados para la plataforma (barras invertidas en Windows, barras diagonales en macOS/Linux)
• Verifique los registros del cliente de escritorio de Claude si falla la conexión
• Verifique que el directorio de su espacio de trabajo exista y se pueda escribir en él
• Asegúrese de que las versiones de Node.js y TypeScript cumplan con los requisitos

Implementación básica

Herramientas disponibles

La implementación proporciona un conjunto de herramientas básicas diseñadas para respaldar la interacción estructurada:

• Operaciones del sistema de archivos : navegar y administrar el contexto del espacio de trabajo
  • pwd , cd , read , write , mkdir , delete , move , rename
• Herramientas de razonamiento : crear espacios para el pensamiento estructurado
  • reason : Desarrollar conocimientos conectados
  • think : Crear espacios temporales para la contemplación
• Sistema de revista : mantener la continuidad del marco
  • journal_create : Documentar desarrollos
  • journal_read : Explora patrones

Uso básico

Compatibilidad multiplataforma

El servidor MCP-PIF está diseñado para funcionar sin problemas en entornos Windows, macOS y Linux:

Manejo de rutas

• Todas las rutas de archivos se normalizan automáticamente para el sistema operativo actual
• La raíz del espacio de trabajo se detecta automáticamente en función del entorno actual
• Se admiten rutas absolutas y relativas dentro del espacio de trabajo

Configuración

• Las variables de entorno proporcionan una forma multiplataforma de configurar el servidor
• Las operaciones de archivo utilizan métodos de ruta de Node.js para garantizar un comportamiento consistente
• Las entradas del diario y otros datos se almacenan en un formato independiente de la plataforma.

Flujo de trabajo de desarrollo

• Los scripts de NPM funcionan en todas las plataformas
• La compilación de TypeScript produce JavaScript independiente de la plataforma
• El manejo de errores tiene en cuenta los comportamientos del sistema de archivos específicos de la plataforma

Marco de implementación

Arquitectura del módulo

El sistema está construido alrededor de herramientas modulares que crean condiciones para el surgimiento estructurado:

Patrones de herramientas

Cada herramienta sigue patrones consistentes manteniendo al mismo tiempo su función única:

• Definiciones de interfaz claras
• Manejo estructurado de errores
• Gestión estatal
• Interacción entre módulos

Entorno de desarrollo

• TypeScript para seguridad de tipos
• Organización basada en módulos
• Registro completo
• Gestión del contexto del espacio de trabajo

Fundamento teórico

Marco de inteligencia personal

El PIF representa un nuevo enfoque para la colaboración entre humanos e IA basado en:

• Creación de condiciones para el surgimiento estructurado
• Mantener la continuidad basada en el marco
• Apoyando el desarrollo progresivo
• Permitir una interacción significativa

Emergencia estructurada

En lugar de prescribir patrones fijos, la implementación crea espacios delimitados donde la comprensión puede surgir a través de:

• Interacción mediada por herramientas
• Estructuras de relación
• Espacios temporales
• Desarrollo progresivo

Continuidad basada en el marco

La comprensión se desarrolla a través de:

• Documentación estructurada
• Descubrimiento de patrones
• Contexto histórico
• Desarrollo evolutivo

Divulgación progresiva

El sistema admite diferentes niveles de participación:

• Uso práctico inmediato
• Descubrimiento de patrones
• Evolución del marco
• Alineación filosófica

Caminos de desarrollo

Usuario de la herramienta

Para aquellos interesados principalmente en la implementación práctica:

1. Comience con el uso básico de herramientas
2. Explorar la documentación del módulo
3. Desarrollar patrones de interacción
4. Descubra las capacidades emergentes

Desarrollador de framework

Para aquellos interesados en ampliar el sistema:

1. Revisar la arquitectura del módulo
2. Comprender los patrones de herramientas
3. Implementar nuevas capacidades
4. Mantener la alineación del marco

Explorador teórico

Para aquellos interesados en patrones más profundos:

1. Principios de implementación del estudio
2. Observar patrones emergentes
3. Contribuir a la evolución del marco
4. Desarrollar una nueva comprensión

Contribuyendo

Este proyecto da la bienvenida a contribuciones que aborden tanto aspectos de implementación como teóricos:

• Desarrollo de herramientas
• Mejora de la documentación
• Descubrimiento de patrones
• Evolución del marco

Documentación

La documentación completa está disponible:

• Documentación del módulo : Documentación de herramientas individuales
• Guía de arquitectura : Diseño y patrones del sistema
• Guía de desarrollo : Patrones de implementación

Direcciones futuras

El proyecto continúa evolucionando a través de:

• Desarrollo de nuevas herramientas
• Descubrimiento de patrones
• Refinamiento del marco
• Participación comunitaria

Filosofía

Esta implementación incorpora una vista donde:

• La comprensión surge a través de la interacción estructurada
• Las herramientas crean espacios para nuevos patrones
• El desarrollo mismo se convierte en una investigación filosófica
• La inteligencia humana y la IA coevolucionan

Notas sobre el uso

El sistema es más que un conjunto de herramientas: es un espacio para explorar cómo la inteligencia humana y la IA pueden desarrollarse mediante la interacción estructurada. Cada sesión es una oportunidad para descubrir nuevos patrones de comprensión y colaboración.