Jentic

Complemento MCP de Jentic

¿Por qué utilizar Jentic MCP?

Jentic MCP permite a los desarrolladores descubrir e integrar rápidamente API y flujos de trabajo externos, sin necesidad de escribir ni mantener código específico de la API. Al aprovechar el protocolo MCP y el entorno de ejecución de Jentic, los desarrolladores pueden:

Busque API y flujos de trabajo por capacidad, no por proveedor o implementación.
Genere instantáneamente ejemplos de código de integración que sean independientes de los detalles específicos de la API.
Evite el código repetitivo y reduzca el mantenimiento confiando en una integración declarativa y estandarizada.
Concéntrese en desarrollar funciones, mientras Jentic MCP maneja la complejidad de la interacción de la API.

Herramientas API

El complemento Jentic MCP proporciona las siguientes herramientas:

search_apis : busca API en el directorio de Jentic que coincidan con necesidades de funcionalidad específicas
load_execution_info : Recupera especificaciones detalladas de las API y operaciones del directorio de Jentic. Esto incluye la información de autenticación que podría necesitar proporcionar en la configuración de mcpServers.jentic.env .
execute : ejecutar una API específica o una operación de flujo de trabajo.

Empezando

El método recomendado es ejecutar el servidor directamente desde el repositorio de GitHub con uvx . Primero deberá instalar uv con:

brew install uv o pip install uv

Obtenga su UUID de Jentic

Para usar el SDK de Jentic, primero debe obtener un UUID de Jentic. La forma más sencilla es usar la CLI de Jentic. Opcionalmente, puede incluir una dirección de correo electrónico para obtener límites de velocidad más altos y acceso anticipado a nuevas funciones.

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

Esto imprimirá su UUID y un comando de exportación para configurarlo en su entorno:

export JENTIC_UUID=<your-jentic-uuid>

Establezca el UUID de Jentic en la configuración de su cliente MCP como se muestra a continuación.

La ubicación del archivo de configuración depende del cliente que utilice y de su sistema operativo. Algunos ejemplos comunes:

Windsurf : ~/.codeium/windsurf/mcp_config.json
Escritorio de Claude : ~/Library/Application Support/Claude/claude_desktop_config.json
Código de Claude : ~/.claude.json
Cursor : ~/cursor/.mcp.json

Para otros clientes, consulte la documentación de su cliente para saber cómo agregar servidores 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>"
            }
        }
    }
}

Nota: Después de guardar el archivo de configuración, es posible que deba reiniciar la aplicación cliente (Windsurf, Claude Desktop) para que los cambios surtan efecto.

Uso de la herramienta MCP

Una vez que el servidor MCP esté en funcionamiento, puede usar fácilmente las herramientas MCP en su agente LLM para descubrir y ejecutar API y flujos de trabajo.

search_apis : busca API en el directorio de Jentic que coincidan con necesidades de funcionalidad específicas
load_execution_info : Recupera especificaciones detalladas de las API y operaciones del directorio de Jentic. Esto incluye la información de autenticación que podría necesitar proporcionar en la configuración de mcpServers.jentic.env .
execute : ejecutar una API específica o una operación de flujo de trabajo.

Variables de entorno

Al usar una API que requiere autenticación, la herramienta load_execution_info describirá las variables de entorno necesarias. Puede configurar las variables de entorno mediante la línea de comandos en Windsurf, aunque en algunos clientes como Claude Desktop, deberá agregarlas a la configuración de 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"
            }
        }
    }
}

Alternativa (utilizando la ruta local para el desarrollo):

Use esto si está desarrollando activamente el complemento MCP localmente. Reemplace /path/to/your/project/mcp con la ruta absoluta al directorio de su proyecto.

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

Opcional: agregue una variable de entorno JENTIC_API_URL a su archivo mcp_config.json para apuntar a una API de Jentic específica (funciona con ambos métodos):

{
    "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/"
            }
        }
    }
}

Una vez configurado, reinicie Windsurf y las herramientas Jentic MCP estarán disponibles.

Puede seguir los registros generados por el servidor MCP que se ejecuta localmente ejecutando:

tail /path/to/mcp/jentic_ark2_mcp.log

Instalación

Asegúrese de tener pdm instalado ( pipx install pdm ).

Para instalar el paquete y sus dependencias para el desarrollo:

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

Ejecución del servidor MCP

El complemento Jentic MCP está diseñado para ejecutarse utilizando uvx , que maneja la configuración y ejecución del entorno.

Modo predeterminado (Stdio)

Ejecute el complemento MCP directamente usando uvx , especificando el directorio del proyecto como fuente usando --from y el script mcp :

Desde la ruta local (Desarrollo):

# 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

Desde el repositorio remoto (recomendado para uso general):

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

Esto utiliza automáticamente el comando serve --transport stdio predeterminado definido en la devolución de llamada del script mcp .

Modo HTTP

Para ejecutar el servidor en modo HTTP (por ejemplo, para probar con claude-cli ):

Desde la ruta local (Desarrollo):

# 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

Desde el repositorio remoto (recomendado):

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

Ejecución desde un repositorio Git remoto

También puedes ejecutar el servidor MCP directamente desde una URL de repositorio Git sin clonarlo localmente usando 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

Este comando obtiene la versión especificada, instala sus dependencias en un entorno temporal y ejecuta el comando predeterminado (que es serve --transport stdio ).

Puede agregar otros argumentos como --log-level DEBUG o --mock después del fragmento de URL:

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

Para ejecutar en modo HTTP desde una fuente remota:

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

Otras opciones

Explotación florestal

# 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

Modo simulado

Habilite el modo simulado para el desarrollo sin conectarse al Centro de conocimiento de la API de Jentic real:

# 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

Variables de entorno

Proporcione variables de entorno utilizando un archivo .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

Usando con Claude

El complemento MCP se puede utilizar con Claude u otros LLM que admitan la especificación MCP:

Ejecutar desde el repositorio remoto (recomendado):

# 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

Ejecutar desde la ruta local (desarrollo):

# 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

Desarrollo

Consulte CLAUDE.md para obtener instrucciones de desarrollo detalladas.

Estructura del paquete

src/mcp/ : Paquete principal de MCP
- transport/ : Implementaciones de transporte (HTTP, stdio)
- mock/ : Proveedores de datos simulados para el desarrollo
- tools.py : Definiciones de herramientas
- handlers.py : Controladores de solicitudes
- main.py : puntos de entrada de la CLI
- adapters/ : Implementaciones de adaptadores
- core/ : Funcionalidad principal
tests/ : Conjunto de pruebas

Pruebas

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

Pelusa y formato

Utiliza ruff , black , isort y mypy a través de scripts pdm.

# Run all linters/formatters
pdm run lint

# Run only ruff
pdm run linter

Licencia

Propietario - Jentic

Jentic

Integrations

Complemento MCP de Jentic

¿Por qué utilizar Jentic MCP?

Herramientas API

Empezando

Obtenga su UUID de Jentic

Uso de la herramienta MCP

Variables de entorno

Instalación

Ejecución del servidor MCP

Modo predeterminado (Stdio)

Modo HTTP

Ejecución desde un repositorio Git remoto

Otras opciones

Explotación florestal

Modo simulado

Variables de entorno

Usando con Claude

Desarrollo

Estructura del paquete

Pruebas

Pelusa y formato

Licencia

Tools

Related Resources

Related MCP Servers

MCP Neo4j Server

confluence-mcp

Jira MCP Server

Jotdown

New MCP Servers