Contexto Banco MCP

Descripción general

Context Bank MCP es un proyecto que utiliza el Protocolo de Contexto de Modelo (MCP) para crear una interfaz que permita consultar la base de conocimiento de AtherOS mediante una API. Este proyecto construye un servidor MCP capaz de interactuar con la API de Onyx para crear sesiones de chat y enviar consultas a la base de conocimiento.

Related MCP server: Astro Docs MCP Server

Características

• Crear nuevas sesiones de chat para consultar la base de conocimientos

• Envía mensajes a las sesiones de chat para recibir respuestas de la base de conocimientos

• Formatear y mostrar resultados de la API de Onyx

Tecnologías utilizadas

• Mecanografiado

• Node.js

• SDK del Protocolo de Contexto de Modelo (MCP)

• Zod para validación de datos

• Axios para solicitudes HTTP

Instalación

Configuración

El proyecto utiliza variables de entorno para conectarse a la API de Onyx. Siga estos pasos para configurar su entorno:

Configuración automática (recomendada)

Ejecute el script de configuración para configurar su entorno de forma interactiva:

Este script hará lo siguiente:

1. Crea un archivo .env si no existe

2. Le solicitará su clave API de AtherOS

3. Le permite personalizar la URL base de la API

4. Establecer valores predeterminados para otras opciones de configuración

Configuración manual

1. Copie el archivo de entorno de ejemplo para crear el suyo propio:

2. Edite el archivo .env con su configuración específica:

Variables de entorno

1. Variables de entorno requeridas:

   • ONYX_API_KEY : Su clave API de AtherOS

   • ONYX_API_BASE : URL base para la API de AtherOS (por ejemplo, " http://172.30.22.52:3000 ")

2. Variables de entorno opcionales:

   • PORT : Número de puerto del servidor (predeterminado: 3000)

   • NODE_ENV : Modo de entorno (desarrollo, producción, prueba)

   • LOG_LEVEL : Nivel de registro (información, depuración, error, advertencia)

Uso

Después de la compilación, puede utilizar la herramienta de línea de comandos:

Herramientas API

El proyecto proporciona dos herramientas MCP principales:

1. crear_sesión_de_chat

Crea una nueva sesión de chat para consultar la base de conocimientos.

Parámetros:

• persona_id (predeterminado: 0): ID de usuario

• description (predeterminado: ""): Descripción de la sesión de chat

2. consulta_atheros

Envía un mensaje a la sesión de chat para consultar la base de conocimientos de AtherOS.

Parámetros:

• chat_session_id : ID de la sesión de chat

• message : Contenido del mensaje

• parent_message_id : ID del mensaje principal (puede ser nulo)

Formato de respuesta

Las respuestas a las consultas de la base de conocimientos incluyen:

• ID del mensaje

• Contenido del mensaje

• Consulta reformulada (si está disponible)

• Información sobre los principales documentos fuente (si están disponibles):

  • Nombre del documento

  • Puntuación de relevancia

  • Enlace al documento

Arquitectura

El proyecto está organizado con una estructura sencilla:

• src/index.ts : Punto de entrada principal de la aplicación, define las herramientas MCP y la lógica de conexión

• Utiliza el protocolo stdio para comunicarse con el servidor MCP

Desarrollo

Licencia

ISC