Skip to main content
Glama
deenesjakoruzh
jentic

Jentic

Official
by jentic
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Плагин Jentic MCP

значок кузнеца

Зачем использовать Jentic MCP?

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

  • Выполняйте поиск API и рабочих процессов по возможностям, а не по поставщику или реализации.

  • Мгновенно создавайте примеры кода интеграции, не зависящие от конкретных деталей API.

  • Избегайте шаблонного кода и сократите объем обслуживания, полагаясь на стандартизированную, декларативную интеграцию.

  • Сосредоточьтесь на создании функций, в то время как Jentic MCP справляется со сложностью взаимодействия API.

Related MCP server: Jotdown

API-инструменты

Плагин Jentic MCP предоставляет следующие инструменты:

  1. search_apis : Поиск API в каталоге Jentic, соответствующих определенным функциональным потребностям

  2. load_execution_info : Получить подробные спецификации для API и операций из каталога Jentic. Это будет включать информацию об аутентификации, которую вам может потребоваться предоставить в конфигурации

  3. execute : выполнить определенную операцию API или рабочего процесса.

Начиная

Рекомендуемый метод — запустить сервер напрямую из репозитория GitHub с помощью uvx . Сначала вам нужно будет установить uv с помощью:

brew install uv или pip install uv

Получите свой Jentic UUID

Чтобы использовать Jentic SDK, сначала необходимо получить Jentic UUID. Самый простой способ — использовать Jentic CLI. При желании можно включить адрес электронной почты для более высоких лимитов скорости и раннего доступа к новым функциям.

pip install jentic
jentic register --email '<your_email>'

Эта команда выведет ваш UUID и команду экспорта для его установки в вашей среде:

export JENTIC_UUID=<your-jentic-uuid>

Установите Jentic UUID в конфигурации клиента MCP, как показано ниже.

Расположение файла конфигурации зависит от используемого вами клиента и вашей ОС. Некоторые общие примеры:

  • Виндсерфинг : ~/.codeium/windsurf/mcp_config.json

  • Рабочий стол Клода : ~/Library/Application Support/Claude/claude_desktop_config.json

  • Код Клода : ~/.claude.json

  • Курсор : ~/cursor/.mcp.json

Для других клиентов проверьте документацию вашего клиента, чтобы узнать, как добавлять серверы MCP.

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "JENTIC_UUID": "<your-jentic-uuid>"
            }
        }
    }
}

Примечание: После сохранения файла конфигурации может потребоваться перезапустить клиентское приложение (Windsurf, Claude Desktop), чтобы изменения вступили в силу.

Использование инструмента MCP

После запуска сервера MCP вы можете легко использовать инструменты MCP в своем агенте LLM для обнаружения и выполнения API и рабочих процессов.

  1. search_apis : Поиск API в каталоге Jentic, соответствующих определенным функциональным потребностям

  2. load_execution_info : Получить подробные спецификации для API и операций из каталога Jentic. Это будет включать информацию об аутентификации, которую вам может потребоваться предоставить в конфигурации

  3. execute : выполнить определенную операцию API или рабочего процесса.

Переменные среды

При использовании API, требующего аутентификации, инструмент load_execution_info опишет требуемые переменные среды. Вы можете использовать переменные среды через командную строку в Windsurf, хотя в некоторых клиентах, таких как Claude Desktop, вам нужно будет добавить их в конфигурацию MCP:

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "DISCORD_BOTTOKEN=": "YOUR BOT TOKEN"
            }
        }
    }
}

Альтернатива (использование локального пути для разработки):

Используйте это, если вы активно разрабатываете плагин MCP локально. Замените /path/to/your/project/mcp на абсолютный путь к каталогу вашего проекта.

{
    "mcpServers": {
        "jentic": { 
            "command": "uvx",
            "args": [
                "--from",
                "/path/to/your/project/mcp",
                "mcp" 
            ]
        }
    }
}

Необязательно: добавьте переменную среды JENTIC_API_URL в файл mcp_config.json , чтобы указать на конкретный API Jentic (работает с обоими методами):

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "JENTIC_API_URL": "https://your-jentic-api.url/"
            }
        }
    }
}

После настройки перезапустите Windsurf, и инструменты Jentic MCP станут доступны.

Вы можете отслеживать журналы, сгенерированные локально работающим сервером MCP, выполнив:

tail /path/to/mcp/jentic_ark2_mcp.log

Установка

Установка через Smithery

Чтобы автоматически установить плагин Jentic для Claude Desktop через Smithery :

npx -y @smithery/cli install @jentic/jentic-tools --client claude

Ручная установка

Убедитесь, что у вас установлен pdm ( pipx install pdm ).

Чтобы установить пакет и его зависимости для разработки:

# From the project root directory (e.g., /Users/kc/c/sdk/mcp)
pdm install -G dev

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

Плагин Jentic MCP предназначен для запуска с использованием uvx , который управляет настройкой среды и выполнением.

Режим по умолчанию (Stdio)

Запустите плагин MCP напрямую с помощью uvx , указав каталог проекта в качестве источника с помощью --from и скрипта mcp :

Из локального пути (развитие):

# Use --from with the project directory and specify the 'mcp' script
uvx --from /path/to/your/project/mcp mcp

# Or, if running from within the project directory:
uvx --from . mcp

Из удаленного репозитория (рекомендуется для общего использования):

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  mcp

При этом автоматически используется команда serve --transport stdio по умолчанию, определенная в обратном вызове скрипта mcp .

HTTP-режим

Чтобы запустить сервер в режиме HTTP (например, для тестирования с помощью claude-cli ):

Из локального пути (развитие):

# Default HTTP (port 8010)
uvx --from /path/to/your/project/mcp mcp serve --transport http

# With custom port
uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8080

# With custom host
uvx --from /path/to/your/project/mcp mcp serve --transport http --host 0.0.0.0 --port 8080

Из удаленного репозитория (рекомендуется):

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  mcp serve --transport http --port 8080

Запуск из удаленного репозитория Git

Вы также можете запустить сервер MCP напрямую из URL-адреса репозитория Git, не клонируя его локально, используя uvx --from :

# Example from a specific branch and subdirectory
uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp

# Explanation:
# - git+https://... .git : The repository URL
# - @main   : The branch, tag, or commit hash
# - #subdirectory=mcp     : The folder within the repo containing the pyproject.toml

Эта команда извлекает указанную версию, устанавливает ее зависимости во временной среде и запускает команду по умолчанию (которая называется serve --transport stdio ).

Вы можете добавить другие аргументы, такие как --log-level DEBUG или --mock после фрагмента URL:

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  --log-level DEBUG --mock

Для запуска в режиме HTTP из удаленного источника:

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  serve --transport http --port 8080

Другие варианты

Ведение журнала

# Set logging level (applies to default stdio or explicit serve)
uvx --from /path/to/your/project/mcp mcp --log-level DEBUG
uvx --from /path/to/your/project/mcp mcp serve --transport http --log-level DEBUG

# Log to file (applies to default stdio or explicit serve)
uvx --from /path/to/your/project/mcp mcp --log-file jentic_mcp.log
uvx --from /path/to/your/project/mcp mcp serve --transport http --log-file jentic_mcp.log

Режим имитации

Включите режим имитации для разработки без подключения к фактическому центру знаний API Jentic:

# Mock mode with default stdio
uvx --from /path/to/your/project/mcp mcp --mock

# Mock mode with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --mock

Переменные среды

Укажите переменные среды с помощью файла .env :

# Env file with default stdio
uvx --from /path/to/your/project/mcp mcp --env-file .env

# Env file with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --env-file .env

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

Плагин MCP можно использовать с Claude или другими LLM, которые поддерживают спецификацию MCP:

Запуск из удаленного репозитория (рекомендуется):

# Run the server in HTTP mode first
uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  mcp serve --transport http --port 8000

# Then connect claude-cli
claude-cli --mcp http://localhost:8000

Запуск из локального пути (разработка):

# Run the server in HTTP mode first
uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8000

# Then connect claude-cli
claude-cli --mcp http://localhost:8000

Разработка

Подробные инструкции по разработке см. на сайте CLAUDE.md.

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

  • src/mcp/ : Основной пакет MCP

    • transport/ : Реализации транспорта (HTTP, stdio)

    • mock/ : Поставщики фиктивных данных для разработки

    • tools.py : Определения инструментов

    • handlers.py : Обработчики запросов

    • main.py : точки входа CLI

    • adapters/ : Реализации адаптеров

    • core/ : Основная функциональность

  • tests/ : Тестовый набор

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

# Ensure dev dependencies are installed: pdm install -G dev
pdm run test

Линтинг и форматирование

Использует ruff , black , isort , mypy через скрипты pdm.

# Run all linters/formatters
pdm run lint

# Run only ruff
pdm run linter

Лицензия

Запатентованная разработка - Jentic

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

Tools

Latest Blog Posts

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/jentic/jentic-tools'

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