tpc-server

✨ 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).

🚀 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.

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.