jitapi
JitAPI
Направьте 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Регистрация — Парсинг спецификации OpenAPI, построение графа зависимостей (каким эндпоинтам нужны данные от других эндпоинтов) и создание эмбеддингов для поиска по всем эндпоинтам.
Поиск — Когда вы задаете вопрос, JitAPI создает эмбеддинг вашего запроса и находит наиболее релевантные эндпоинты с помощью косинусного сходства.
Расширение — Граф зависимостей добавляет все необходимые предварительные эндпоинты (например, «сначала нужно вызвать GET /users, чтобы получить user_id для POST /orders»).
Выполнение — Claude получает схемы эндпоинтов и выполняет API-вызовы, передавая данные между шагами.
Инструменты MCP
Инструмент | Описание |
| Регистрация API по URL спецификации OpenAPI |
| Список всех зарегистрированных API и количество их эндпоинтов |
| Семантический поиск по эндпоинтам на естественном языке |
| Поиск релевантных эндпоинтов с разрешением зависимостей и полными схемами |
| Получение полной схемы для конкретного эндпоинта |
| Выполнение одного API-вызова с аутентификацией, параметрами пути, параметрами запроса и телом |
| Настройка аутентификации (API-ключ, bearer-токен, базовая аутентификация) |
| Удаление зарегистрированного API и всех его данных |
Настройка
Claude Code
Создайте .mcp.json в директории вашего проекта (или ~/.claude.json для глобального доступа):
{
"mcpServers": {
"jitapi": {
"command": "uvx",
"args": ["jitapi"]
}
}
}Claude Desktop
Добавьте в конфигурацию Claude Desktop:
ОС | Путь к конфигурации |
macOS |
|
Windows |
|
Linux |
|
{
"mcpServers": {
"jitapi": {
"command": "uvx",
"args": ["jitapi"]
}
}
}Провайдеры эмбеддингов
JitAPI работает «из коробки» с локальными эмбеддингами (fastembed) — API-ключи не нужны. Для повышения качества поиска в крупных API можно добавить облачного провайдера эмбеддингов:
Провайдер | Качество | Настройка |
Локальный (по умолчанию) | Хорошее | Ничего — работает сразу |
Voyage AI (рекомендуется) | Отличное |
|
OpenAI | Отличное |
|
Cohere | Очень хорошее |
|
Установите 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.
Переменные окружения
Переменная | Обязательно | Описание |
| Нет | API-ключ Voyage AI (рекомендуемый облачный провайдер) |
| Нет | API-ключ OpenAI (альтернативный облачный провайдер) |
| Нет | API-ключ Cohere (альтернативный облачный провайдер) |
| Нет | Директория данных (по умолчанию: |
| Нет | 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 toolscall_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
Scored across 8 tools
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.
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).
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.
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
Related MCP Connectors
Turn any task into the right API calls: discover, evaluate, and integrate public APIs.
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
Your AI Agent's Infrastructure Layer. Connect Claude, Copilot, Codex, or ChatGPT to 200+ managed open source services. Start databases, pipelines, and applications through natural language.
Connect ChatGPT or Claude to your CRM, store or shipping API. Keys stay out of the chat.
Related MCP Servers
- FlicenseBqualityNot gradedmaintenanceBridges Claude Code to a Cloud Orchestrator API, providing access to multi-AI consensus, web search, code execution sandboxes, long-term memory, knowledge graphs, deployment management, and 20+ integrated AI and developer tools.28-
- AlicenseNot gradedqualityDmaintenanceA 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.16MIT
- FlicenseNot gradedqualityNot gradedmaintenanceUniversal 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 npm5-
- AlicenseAqualityCmaintenanceTurn 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.240 npm1MIT