Skip to main content
Glama
Sign In
deenesjakoruzh

Jentic

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

Integrations

  • Enables authentication and interaction with Discord APIs through the Jentic MCP plugin, requiring a Discord bot token for operations.

Плагин 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

Установка

Убедитесь, что у вас установлен 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

You must be authenticated.

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

Tools

Джентик

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

          Related Resources

          Related MCP Servers

          • MCP Neo4j Server

            da-okazaki
            A
            security
            A
            license
            A
            quality
            This server enables interaction between Neo4j databases and Claude Desktop, allowing users to execute Cypher queries, create nodes, and establish relationships in the database.
            Last updated -
            3
            72
            24
            TypeScript
            MIT License

          • Jira MCP Server

            KS-GEN-AI
            A
            security
            A
            license
            A
            quality
            A TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.
            Last updated -
            11
            20
            JavaScript
            MIT License
            • Apple

          • Jotdown

            Harry-027
            -
            security
            -
            license
            -
            quality
            Jotdown
            Last updated -
            11
            Rust
            MIT License

          View all related MCP servers

          New MCP Servers

          ID: voxg3anlkq