Skip to main content
Glama
deenesjakoruzh

MCP-Smallest.ai

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

изображение

MCP-Smallest.ai

Реализация сервера Model Context Protocol (MCP) для интеграции API Smallest.ai. Этот проект предоставляет стандартизированный интерфейс для взаимодействия с системой управления базой знаний Smallest.ai.

Архитектура

Обзор системы

Без названия-2025-03-21-0340(6)

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

Детали компонента

1. Уровень клиентского приложения

  • Реализует клиентский протокол MCP

  • Обрабатывает форматирование запроса

  • Управляет анализом ответов

  • Обеспечивает обработку ошибок

2. Уровень сервера MCP

  • Обработчик протоколов

    • Управляет коммуникацией по протоколу MCP

    • Обрабатывает клиентские соединения

    • Направляет запросы соответствующим инструментам

  • Реализация инструмента

    • Инструменты управления базой знаний

    • Проверка параметров

    • Форматирование ответа

    • Обработка ошибок

  • API-интеграция

    • API-коммуникация Smallest.ai

    • Управление аутентификацией

    • Обработка запросов/ответов

3. Уровень API Smallest.ai

  • Управление базой знаний

  • Хранение и извлечение данных

  • Аутентификация и авторизация

Поток данных

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

Архитектура безопасности

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

Обзор

Этот проект реализует сервер MCP, который действует как промежуточное ПО между клиентами и API Smallest.ai. Он предоставляет стандартизированный способ взаимодействия с функциями управления базой знаний Smallest.ai через протокол контекста модели.

Архитектура

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

Компоненты

  1. MCP-сервер

    • Обрабатывает запросы клиентов

    • Управляет коммуникацией API

    • Предоставляет стандартизированные ответы

    • Реализует обработку ошибок

  2. Инструменты базы знаний

    • listKnowledgeBases : список всех баз знаний

    • createKnowledgeBase : создает новые базы знаний

    • getKnowledgeBase : извлекает конкретные сведения из базы знаний

  3. Ресурс документации

    • Доступно на docs://smallest.ai

    • Предоставляет инструкции по использованию и примеры

Предпосылки

  • Node.js 18+ или среда выполнения Bun

  • API-ключ Smallest.ai

  • Знание TypeScript

Установка

  1. Клонируйте репозиторий:

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

  1. Установите зависимости:

bun install

  1. Создайте файл .env в корневом каталоге:

SMALLEST_AI_API_KEY=your_api_key_here

Конфигурация

Создайте файл config.ts с конфигурацией API Smallest.ai:

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

Использование

Запуск сервера

bun run index.ts

Тестирование сервера

bun run test-client.ts

Доступные инструменты

  1. Список баз знаний

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

  1. Создать базу знаний

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

  1. Получить базу знаний

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

Формат ответа

Все ответы имеют следующую структуру:

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

Обработка ошибок

На сервере реализована комплексная обработка ошибок:

  • HTTP-ошибки

  • Ошибки API

  • Ошибки проверки параметров

  • Типобезопасные ответы на ошибки

Разработка

Структура проекта

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

Добавление новых инструментов

  1. Определите инструмент в index.ts :

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

  1. Обновление документации в ресурсе:

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

Безопасность

  • Ключи API хранятся в переменных среды.

  • Все запросы аутентифицированы.

  • Реализована проверка параметров

  • Сообщения об ошибках очищаются

Внося вклад

  1. Форк репозитория

  2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

  3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

  4. Отправить в ветку ( git push origin feature/amazing-feature )

  5. Открыть запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Благодарности

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

Реализация сервера Model Context Protocol, предоставляющая стандартизированный интерфейс для взаимодействия с системой управления базой знаний Smallest.ai.

  1. Архитектура
    1. Обзор системы
    2. Детали компонента
    3. Поток данных
    4. Архитектура безопасности
  2. Обзор
    1. Архитектура
      1. Компоненты
    2. Предпосылки
      1. Установка
        1. Конфигурация
          1. Использование
            1. Запуск сервера
            2. Тестирование сервера
            3. Доступные инструменты
          2. Формат ответа
            1. Обработка ошибок
              1. Разработка
                1. Структура проекта
                2. Добавление новых инструментов
              2. Безопасность
                1. Внося вклад
                  1. Лицензия
                    1. Благодарности

                      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