Skip to main content
Glama
deenesjakoruzh

MCP-Smallest.ai

by VinayakTiwari1103
GitHub
TypeScript
3
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

imagen

MCP-Smallest.ai

Implementación de un servidor del Protocolo de Contexto de Modelo (MCP) para la integración de la API de Smallest.ai. Este proyecto proporciona una interfaz estandarizada para interactuar con el sistema de gestión de la base de conocimientos de Smallest.ai.

Arquitectura

Descripción general del sistema

Sin título-2025-03-21-0340(6)

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ │ │ │ │ │ │ Client App │◄────┤ MCP Server │◄────┤ Smallest.ai │ │ │ │ │ │ API │ └─────────────────┘ └─────────────────┘ └─────────────────┘

Detalles del componente

1. Capa de aplicación del cliente

  • Implementa el protocolo de cliente MCP

  • Maneja el formato de la solicitud

  • Gestiona el análisis de respuestas

  • Proporciona manejo de errores

2. Capa de servidor MCP

  • Manejador de protocolo

    • Gestiona la comunicación del protocolo MCP

    • Maneja las conexiones del cliente

    • Envía solicitudes a las herramientas adecuadas

  • Implementación de herramientas

    • Herramientas de gestión de bases de conocimientos

    • Validación de parámetros

    • Formato de respuesta

    • Manejo de errores

  • Integración de API

    • Comunicación API de Smallest.ai

    • Gestión de autenticación

    • Manejo de solicitudes/respuestas

3. Capa de API de Smallest.ai

  • Gestión de la base de conocimientos

  • Almacenamiento y recuperación de datos

  • Autenticación y autorización

Flujo de datos

1. Client Request └─► MCP Protocol Validation └─► Tool Parameter Validation └─► API Request Formation └─► Smallest.ai API Call └─► Response Processing └─► Client Response

Arquitectura de seguridad

┌─────────────────┐ │ Client Auth │ └────────┬────────┘ │ ┌────────▼────────┐ │ MCP Validation │ └────────┬────────┘ │ ┌────────▼────────┐ │ API Auth │ └────────┬────────┘ │ ┌────────▼────────┐ │ Smallest.ai │ └─────────────────┘

Descripción general

Este proyecto implementa un servidor MCP que actúa como middleware entre los clientes y la API de Smallest.ai. Proporciona una forma estandarizada de interactuar con las funciones de gestión de la base de conocimiento de Smallest.ai mediante el Protocolo de Contexto de Modelo.

Arquitectura

[Client Application] <---> [MCP Server] <---> [Smallest.ai API]

Componentes

  1. Servidor MCP

    • Maneja las solicitudes de los clientes

    • Gestiona la comunicación API

    • Proporciona respuestas estandarizadas

    • Implementa el manejo de errores

  2. Herramientas de la base de conocimientos

    • listKnowledgeBases : enumera todas las bases de conocimiento

    • createKnowledgeBase : Crea nuevas bases de conocimiento

    • getKnowledgeBase : recupera detalles específicos de la base de conocimientos

  3. Recurso de documentación

    • Disponible en docs://smallest.ai

    • Proporciona instrucciones de uso y ejemplos.

Prerrequisitos

  • Node.js 18+ o entorno de ejecución de Bun

  • Clave API de Smallest.ai

  • Conocimiento de TypeScript

Instalación

  1. Clonar el repositorio:

git clone https://github.com/yourusername/MCP-smallest.ai.git cd MCP-smallest.ai

  1. Instalar dependencias:

bun install

  1. Cree un archivo .env en el directorio raíz:

SMALLEST_AI_API_KEY=your_api_key_here

Configuración

Cree un archivo config.ts con la configuración de su API de Smallest.ai:

export const config = { API_KEY: process.env.SMALLEST_AI_API_KEY, BASE_URL: 'https://atoms-api.smallest.ai/api/v1' };

Uso

Iniciando el servidor

bun run index.ts

Probando el servidor

bun run test-client.ts

Herramientas disponibles

  1. Lista de bases de conocimiento

await client.callTool({ name: "listKnowledgeBases", arguments: {} });

  1. Crear una base de conocimientos

await client.callTool({ name: "createKnowledgeBase", arguments: { name: "My Knowledge Base", description: "Description of the knowledge base" } });

  1. Obtener base de conocimientos

await client.callTool({ name: "getKnowledgeBase", arguments: { id: "knowledge_base_id" } });

Formato de respuesta

Todas las respuestas siguen esta estructura:

{ content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }

Manejo de errores

El servidor implementa un manejo integral de errores:

  • Errores HTTP

  • Errores de API

  • Errores de validación de parámetros

  • Respuestas de error de tipo seguro

Desarrollo

Estructura del proyecto

MCP-smallest.ai/ ├── index.ts # MCP server implementation ├── test-client.ts # Test client implementation ├── config.ts # Configuration file ├── package.json # Project dependencies ├── tsconfig.json # TypeScript configuration └── README.md # This file

Agregar nuevas herramientas

  1. Define la herramienta en index.ts :

server.tool( "toolName", { param1: z.string(), param2: z.number() }, async (args) => { // Implementation } );

  1. Actualizar la documentación en el recurso:

server.resource( "documentation", "docs://smallest.ai", async (uri) => ({ contents: [{ uri: uri.href, text: `Updated documentation...` }] }) );

Seguridad

  • Las claves API se almacenan en variables de entorno

  • Todas las solicitudes están autenticadas

  • Se implementa la validación de parámetros

  • Los mensajes de error se desinfectan

Contribuyendo

  1. Bifurcar el repositorio

  2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

  3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

  4. Empujar a la rama ( git push origin feature/amazing-feature )

  5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Una implementación de servidor de protocolo de contexto de modelo que proporciona una interfaz estandarizada para interactuar con el sistema de gestión de base de conocimientos de Smallest.ai.

  1. Arquitectura
    1. Descripción general del sistema
    2. Detalles del componente
    3. Flujo de datos
    4. Arquitectura de seguridad
  2. Descripción general
    1. Arquitectura
      1. Componentes
    2. Prerrequisitos
      1. Instalación
        1. Configuración
          1. Uso
            1. Iniciando el servidor
            2. Probando el servidor
            3. Herramientas disponibles
          2. Formato de respuesta
            1. Manejo de errores
              1. Desarrollo
                1. Estructura del proyecto
                2. Agregar nuevas herramientas
              2. Seguridad
                1. Contribuyendo
                  1. Licencia
                    1. Expresiones de gratitud

                      Related MCP Servers

                      • MCP Toolkit

                        zxfgds
                        -
                        security
                        F
                        license
                        -
                        quality
                        A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
                        Last updated -
                        36
                        1

                      • MCP Boilerplate

                        iamsrikanthnani
                        -
                        security
                        A
                        license
                        -
                        quality
                        A server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.
                        Last updated -
                        0
                        10
                        MIT License

                      • MCP AI Chat LangChain

                        badrinathvm
                        -
                        security
                        F
                        license
                        -
                        quality
                        A basic Model Context Protocol server implementation that demonstrates core functionality including tools and resources for AI chat applications.
                        Last updated -

                      • RL-MCP

                        rlefko
                        -
                        security
                        F
                        license
                        -
                        quality
                        A Model Context Protocol server that provides AI models with structured access to external data and services, acting as a bridge between AI assistants and applications, databases, and APIs in a standardized, secure way.
                        Last updated -
                        2

                      View all related MCP servers

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/VinayakTiwari1103/MCP-smallest-ai'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server