✨ Servidor TPC ✨

¡Realice un seguimiento de los pensamientos 🧠, planes 📝 y cambios ✅ de su agente (o proyecto)!

TPC Server proporciona un servicio backend para registrar, almacenar y recuperar el proceso de razonamiento, las acciones previstas y los pasos ejecutados por agentes de IA o proyectos colaborativos. Desarrollado con FastAPI, MCP-Server y SQLAlchemy.

🤔 ¿Qué es TPC?

La idea central es crear un registro estructurado e interconectado:

• Pensamientos (🧠): Registre ideas, observaciones, consideraciones o puntos de datos sin procesar antes de decidir la acción.

• Planes (📝): Definen cursos de acción, estrategias, objetivos o enfoques previstos, a menudo derivados de pensamientos.

• Cambios (✅): Registra acciones concretas tomadas o modificaciones realizadas, generalmente vinculadas a un plan específico que ayudan a ejecutar.

Este servidor facilita el registro de estos elementos y sus relaciones (Pensamientos <-> Planes -> Cambios).

Related MCP server: MeshMind

🚀 Características

• 🧠 Seguimiento de pensamientos, 📝 planes y ✅ cambios: modelos y almacenamiento dedicados para cada concepto.

• 🔗 Datos interconectados: vincula los pensamientos con los planes (de muchos a muchos) y los cambios con los planes (de muchos a uno).

• 🌐 Interfaz web: Vistas HTML simples para explorar actividades recientes, pensamientos, planes y cambios.

• 🔌 API JSON: puntos finales para la recuperación programática de datos (elementos recientes, todos los pensamientos/planes/cambios).

• 🤖 Herramientas del agente (MCP): expone funciones a través de mcp-server para que los agentes de IA interactúen con la tienda TPC ( add_thought , create_plan , log_change , get_... ).

• Backend de base de datos: utiliza SQLAlchemy (por defecto SQLite, fácilmente configurable a través de URL).

• ⚙️ Configurable: establezca la URL de la base de datos, el host, el puerto y el transporte de comunicación del agente (SSE/stdio) a través de .env .

• 🪄 Creación automática de tablas: las tablas de base de datos se crean automáticamente en la primera ejecución si no existen.

🛠️ Instalación y configuración

1. Clonar el repositorio:

   git clone [https://github.com/suttonwilliamd/tpc-server.git](https://github.com/suttonwilliamd/tpc-server.git)
   cd tpc-server

2. Crear y activar entorno virtual:

   # Create environment
   python -m venv venv
   
   # Activate (macOS/Linux)
   source venv/bin/activate
   
   # Activate (Windows - Git Bash/WSL)
   source venv/Scripts/activate
   
   # Activate (Windows - Command Prompt/PowerShell)
   .\venv\Scripts\activate

3. Dependencias de instalación:

   Install using:
   ```bash
   pip install -r requirements.txt

4. Configurar el entorno: Cree un archivo .env en la raíz del proyecto:

   # .env file
   
   # --- Database ---
   # Default: SQLite in project root. Use postgresql://user:pass@host:port/db for PostgreSQL, etc.
   DATABASE_URL="sqlite:///./tpc_server.db"
   
   # --- Server Network ---
   HOST="0.0.0.0"     # Listen on all network interfaces
   PORT="8050"        # Port for FastAPI and MCP SSE
   
   # --- Agent Communication ---
   # 'sse' (Server-Sent Events over HTTP) or 'stdio' (Standard Input/Output)
   TRANSPORT="sse"

▶️ Ejecución del servidor

Asegúrese de que su entorno virtual esté activo y que esté en la raíz del proyecto.

python main.py

El servidor se iniciará y mostrará los registros de Uvicorn (para FastAPI) y, posiblemente, del servidor MCP. Debería ver un resultado que indique que el servidor se está ejecutando en el HOST y PORT configurados.

💡 Uso

🖥️ Interfaz web

Acceda a la interfaz web sencilla a través de su navegador (predeterminado: http://localhost:8050 ):

• / : Resumen de las 10 actividades más recientes.

• /thoughts : enumera todos los pensamientos registrados.

• /plans : enumera todos los planes registrados.

• /changes : enumera todos los cambios registrados (con los títulos de los planes asociados).

💻 API JSON

Obtener datos mediante programación:

• GET /api/recent-activity : lista combinada de los 10 pensamientos, planes y cambios más recientes.

• GET /api/thoughts : Lista de todos los pensamientos.

• GET /api/plans : Lista de todos los planes.

• GET /api/changes : Lista de todos los cambios (incluido plan_title ).

Herramientas del agente (a través de MCP)

Los agentes de IA se conectan al servidor MCP (utilizando el TRANSPORT configurado) para usar estas herramientas:

• add_thought(...) : Graba un nuevo pensamiento.

• create_plan(...) : Define un nuevo plan.

• log_change(...) : Registra una acción realizada contra un plan.

• get_recent_thoughts(...) : recuperar los últimos pensamientos.

• get_active_plans() : recupera todos los planes 'activos'.

• get_changes_by_plan(...) : Obtener cambios para un ID de plan específico.

• get_thought_details(...) : Obtener detalles para un ID de pensamiento específico (incluidos los planes vinculados).

• get_plan_details(...) : Obtener detalles para un ID de plan específico (incluidos pensamientos/cambios vinculados).

(Consulte LLM.txt para obtener instrucciones detalladas del agente sobre los argumentos y el uso de la herramienta).

🗄️ Base de datos

• El valor predeterminado es un archivo SQLite ( tpc_server.db ) en el directorio del proyecto: simple y no requiere un servidor de base de datos separado.

• Cambie fácilmente a PostgreSQL, MySQL , etc., cambiando DATABASE_URL en .env e instalando el controlador apropiado (por ejemplo, pip install psycopg2-binary ).

• SQLAlchemy crea automáticamente las tablas si no existen al iniciar el servidor.

🙌 Contribuyendo

¡Agradecemos contribuciones, problemas y solicitudes de funcionalidad! No dudes en consultar la página de problemas o enviar una solicitud de incorporación de cambios.