Skip to main content
Glama
deenesjakoruzh

Jentic

Official
by jentic
GitHub
Python
Apache 2.0
5
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Плагин Jentic MCP

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

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

  • Выполняйте поиск API и рабочих процессов по возможностям, а не по поставщику или реализации.
  • Мгновенно создавайте примеры кода интеграции, не зависящие от конкретных деталей API.
  • Избегайте шаблонного кода и сократите объем обслуживания, полагаясь на стандартизированную, декларативную интеграцию.
  • Сосредоточьтесь на создании функций, в то время как Jentic MCP справляется со сложностью взаимодействия API.

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

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

  1. search_apis : Поиск API в каталоге Jentic, соответствующих определенным функциональным потребностям
  2. load_execution_info : Получить подробные спецификации для API и операций из каталога Jentic. Это будет включать информацию об аутентификации, которую вам может потребоваться предоставить в конфигурации mcpServers.jentic.env .
  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. Это будет включать информацию об аутентификации, которую вам может потребоваться предоставить в конфигурации mcpServers.jentic.env .
  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?

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

Джентик

  1. Зачем использовать Jentic MCP?
    1. API-инструменты
      1. Начиная
        1. Получите свой Jentic UUID
        2. Использование инструмента MCP
        3. Переменные среды
      2. Установка
        1. Установка через Smithery
        2. Ручная установка
      3. Запуск сервера MCP
        1. Режим по умолчанию (Stdio)
        2. HTTP-режим
        3. Запуск из удаленного репозитория Git
        4. Другие варианты
        5. Использование с Клодом
      4. Разработка
        1. Структура пакета
        2. Тестирование
        3. Линтинг и форматирование
      5. Лицензия

        Related Resources

        Related MCP Servers

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

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