Skip to main content
Glama

JitAPI

PyPI PyPI Downloads License: MIT Python 3.10+

Направьте Claude на любой API. JitAPI автоматически определяет, какие эндпоинты вызывать и в каком порядке.

JitAPI — это MCP-сервер, который позволяет Claude взаимодействовать с любым API на основе его спецификации OpenAPI. Вместо того чтобы загружать сотни эндпоинтов в контекст, JitAPI использует семантический поиск и граф зависимостей, чтобы выводить только то, что нужно, — а затем Claude планирует и выполняет вызовы.

https://github.com/user-attachments/assets/53f72f89-a41a-4a9c-a688-ec876ea05fbd


Проблема

У Stripe более 300 эндпоинтов. У GitHub — более 800. Загрузка полной спецификации в контекст Claude расходует токены и приводит к галлюцинациям. Написание отдельного MCP-сервера для каждого используемого API не масштабируется.

JitAPI решает эту проблему: зарегистрируйте любую спецификацию OpenAPI один раз, а затем запрашивайте то, что вам нужно, на обычном английском языке. Он находит нужные эндпоинты, разрешает зависимости между ними и позволяет Claude выполнять вызовы.

Related MCP server: OpenAPI to MCP

Быстрый старт

pip install jitapi

Добавьте в конфигурацию Claude Code (.mcp.json):

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"]
    }
  }
}

Вот и всё. API-ключи не требуются — JitAPI использует локальные эмбеддинги «из коробки».

Затем в Claude:

You: Register the GitHub API from https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json

Claude: ✓ Registered GitHub v3 REST API — 1,107 endpoints indexed

You: List my repos

Claude: [searches for "list repositories for authenticated user" → finds GET /user/repos → executes]
Here are your repositories: ...

Оркестрация нескольких API

Главная функция: регистрируйте несколько API и задавайте вопросы, охватывающие их все. JitAPI выполняет поиск по всем зарегистрированным API, а Claude связывает вызовы в цепочку.

You: Register the TMDB API and OpenWeatherMap API
Claude: ✓ Registered both APIs

You: Find the top popular movie on TMDB, then get the weather where it was filmed

Claude: [searches TMDB → GET /movie/popular → GET /movie/{id} for production locations
         → searches OpenWeather → GET /data/2.5/weather with the city]

The #1 popular movie is "Inception", filmed in Los Angeles.
Current weather in LA: 72°F, partly cloudy.

Как это работает

Register API                          Ask a question
     │                                      │
     ▼                                      ▼
Parse OpenAPI spec               Embed query → vector search
     │                                      │
     ▼                                      ▼
Build dependency graph           Find relevant endpoints
     │                                      │
     ▼                                      ▼
Embed all endpoints              Expand with dependencies
     │                                      │
     ▼                                      ▼
Store in vector DB               Return schemas → Claude executes
  1. Регистрация — Парсинг спецификации OpenAPI, построение графа зависимостей (каким эндпоинтам нужны данные от других эндпоинтов) и создание эмбеддингов для поиска по всем эндпоинтам.

  2. Поиск — Когда вы задаете вопрос, JitAPI создает эмбеддинг вашего запроса и находит наиболее релевантные эндпоинты с помощью косинусного сходства.

  3. Расширение — Граф зависимостей добавляет все необходимые предварительные эндпоинты (например, «сначала нужно вызвать GET /users, чтобы получить user_id для POST /orders»).

  4. Выполнение — Claude получает схемы эндпоинтов и выполняет API-вызовы, передавая данные между шагами.

Инструменты MCP

Инструмент

Описание

register_api

Регистрация API по URL спецификации OpenAPI

list_apis

Список всех зарегистрированных API и количество их эндпоинтов

search_endpoints

Семантический поиск по эндпоинтам на естественном языке

get_workflow

Поиск релевантных эндпоинтов с разрешением зависимостей и полными схемами

get_endpoint_schema

Получение полной схемы для конкретного эндпоинта

call_api

Выполнение одного API-вызова с аутентификацией, параметрами пути, параметрами запроса и телом

set_api_auth

Настройка аутентификации (API-ключ, bearer-токен, базовая аутентификация)

delete_api

Удаление зарегистрированного API и всех его данных

Настройка

Claude Code

Создайте .mcp.json в директории вашего проекта (или ~/.claude.json для глобального доступа):

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"]
    }
  }
}

Claude Desktop

Добавьте в конфигурацию Claude Desktop:

ОС

Путь к конфигурации

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"]
    }
  }
}

Провайдеры эмбеддингов

JitAPI работает «из коробки» с локальными эмбеддингами (fastembed) — API-ключи не нужны. Для повышения качества поиска в крупных API можно добавить облачного провайдера эмбеддингов:

Провайдер

Качество

Настройка

Локальный (по умолчанию)

Хорошее

Ничего — работает сразу

Voyage AI (рекомендуется)

Отличное

pip install jitapi[voyage] + установите VOYAGE_API_KEY

OpenAI

Отличное

pip install jitapi[openai] + установите OPENAI_API_KEY

Cohere

Очень хорошее

pip install jitapi[cohere] + установите COHERE_API_KEY

Установите API-ключ в блоке env вашей конфигурации MCP:

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"],
      "env": {
        "VOYAGE_API_KEY": "your-key-here"
      }
    }
  }
}

Провайдер определяется автоматически на основе доступных переменных окружения. Приоритет: Voyage AI > OpenAI > Cohere > локальный.

Аутентификация

Настройте аутентификацию API после регистрации. Рекомендуемый подход использует переменные окружения, чтобы секреты никогда не записывались на диск:

{
  "mcpServers": {
    "jitapi": {
      "command": "uvx",
      "args": ["jitapi"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "OPENWEATHER_API_KEY": "your-key-here"
      }
    }
  }
}

Затем скажите Claude использовать переменную окружения:

You: Set bearer auth for GitHub using env var GITHUB_TOKEN
Claude: [calls set_api_auth with auth_type="bearer", env_var="GITHUB_TOKEN"]
✓ Auth configured for github (from env var $GITHUB_TOKEN)

С помощью env_var JitAPI считывает секрет из окружения во время запроса — сохраняется только имя переменной окружения, но никогда не сами учетные данные.

Вы также можете передать учетные данные напрямую (они будут сохранены в ~/.jitapi/auth.json с правами доступа 0600):

You: Set API key auth for OpenWeather with param name "appid"
Claude: [calls set_api_auth with auth_type="api_key_query", credential="...", param_name="appid"]
✓ Auth configured for openweather

Поддерживаемые типы аутентификации: bearer, api_key_header, api_key_query, basic.

Примечание по безопасности: При использовании env_var учетные данные разрешаются во время выполнения и никогда не касаются файловой системы. При прямой передаче credential секреты хранятся в виде обычного текста JSON в ~/.jitapi/auth.json (права доступа к файлу 0600, к директории 0700). Для использования в продакшене отдавайте предпочтение подходу с env_var.

Переменные окружения

Переменная

Обязательно

Описание

VOYAGE_API_KEY

Нет

API-ключ Voyage AI (рекомендуемый облачный провайдер)

OPENAI_API_KEY

Нет

API-ключ OpenAI (альтернативный облачный провайдер)

COHERE_API_KEY

Нет

API-ключ Cohere (альтернативный облачный провайдер)

JITAPI_STORAGE_DIR

Нет

Директория данных (по умолчанию: ~/.jitapi)

JITAPI_LOG_LEVEL

Нет

DEBUG, INFO, WARNING, ERROR (по умолчанию: INFO)

Разработка

git clone https://github.com/nk3750/jitapi.git
cd jitapi
pip install -e ".[dev]"
pytest
ruff check src/

Лицензия

MIT

Available Tools

8 tools
call_apiB

Execute an API call. Make sure authentication is configured first.

Inputs: api_id (required), endpoint_id (required), path_params, query_params, +1 more.

delete_apiA

Delete a registered API and all its data including endpoints, embeddings, dependency graph, and authentication credentials.

Inputs: api_id (required).

get_endpoint_schemaB

Get the full schema for a specific endpoint. Use this to get detailed parameter and response information.

Inputs: api_id (required), endpoint_id (required).

get_workflowA

Get relevant endpoints with dependency resolution and full schemas for accomplishing a task. Returns search results expanded with their dependencies so you can plan and execute the right API calls in the right order. After reviewing the results, use call_api to execute each step.

Inputs: query (required), api_id (required), max_steps.

list_apisB

List all registered APIs with their basic information.

Inputs: no named parameters.

register_apiA

Register a new API by ingesting its OpenAPI specification. This parses the spec, builds a dependency graph, and creates searchable embeddings.

Inputs: api_id (required), spec_url (required).

search_endpointsA

Search for API endpoints using natural language. Returns semantically similar endpoints based on the query.

Inputs: query (required), api_id, top_k.

set_api_authA

Configure authentication for an API. Supports API key (header or query param) and bearer token auth. Use env_var to reference a secret from an environment variable — the credential is then resolved at request time and never stored on disk.

Inputs: api_id (required), auth_type (required), credential, env_var, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: register/delete/list for API lifecycle management, search_endpoints for discovery, get_endpoint_schema for detailed inspection, get_workflow for task planning with dependencies, set_api_auth for configuration, and call_api for execution. No overlapping functionality.

    Naming Consistency5/5

    Consistent snake_case throughout with verb_noun pattern (call_api, delete_api, list_apis, register_api, search_endpoints, get_workflow, get_endpoint_schema, set_api_auth). All use standard CRUD-style verbs (get, list, search, call, set, register, delete).

    Tool Count5/5

    8 tools is well-scoped for an API management server covering the full lifecycle: registration, listing, deletion, authentication, discovery (search), inspection (schema), planning (workflow), and execution. Each tool earns its place without redundancy.

    Completeness4/5

    Covers the core API lifecycle well (register, list, delete, auth, search, call) with helpful additions like workflow planning. Minor gaps: no get_api for specific API details (only list_apis), no update_api for refreshing specs without full deletion, and no way to remove auth without deleting the entire API.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A standalone proxy that transforms any OpenAPI or Swagger-described REST API into an MCP server by mapping API operations to executable MCP tools. It enables AI clients to interact with existing web services through automated HTTP requests based on their official documentation.
      16
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Universal AI API Orchestrator. 850 tools across 53 services under a single MCP interface. Connect Claude, GPT, or Gemini to Stripe, Slack, GitHub, LinkedIn, Cloudflare, Shopify, Twilio, and 46 more via natural language. $0.10/execution, no subscription. Patent Pending.
      274 npm
      5
      -
    • A
      license
      A
      quality
      C
      maintenance
      Turn any OpenAPI spec into MCP tools for Claude — instantly. Point mcp-openapi at any OpenAPI 3.x spec and Claude can call every endpoint through natural language. No custom integration code. No manual tool definitions. One line of config.
      2
      40 npm
      1
      MIT