Skip to main content
Glama
deenesjakoruzh

MCP-Smallest.ai

by VinayakTiwari1103
OverviewInspectNewSchemaRelated ServersScore
TypeScript
Remote
3

изображение

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?

Related Resources

Tools

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 -
    5
    2

  • 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 -
    1
    11
    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