Servidor Fastn

El servidor Fastn es una plataforma potente y escalable que permite el registro y la ejecución dinámicos de herramientas según las definiciones de API. Se integra a la perfección con servicios como Claude.ai y Cursor.ai, proporcionando una solución de servidor unificada para una amplia gama de tareas. Gracias a su robusta arquitectura, Fastn ofrece un rendimiento y una flexibilidad excepcionales para operaciones en tiempo real basadas en API.

Empezando

Instalación del paquete (recomendado)

La forma más fácil de instalar el servidor Fastn es usando pip:

pip install fastn-mcp-server

Después de la instalación, puede ejecutar el servidor con:

fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

Al utilizar la instalación de paquetes, su configuración para los asistentes de IA se verá así:

macOS/Linux:

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/fastn-mcp-server",
            "args": [
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

Ventanas:

{
    "mcpServers": {
        "fastn": {
            "command": "C:\\path\\to\\fastn-mcp-server.exe",
            "args": [
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

Para encontrar la ruta exacta del comando fastn-server instalado:

En macOS/Linux: which fastn-server
En Windows: where fastn-server

Características

Soporte de plataforma integrado : utilice servicios como Slack, Notion, HubSpot y muchos más a través del servidor Fastn después de completar la sencilla configuración.
Soporte de registro : sistema de registro integral
Manejo de errores : gestión robusta de errores para diversos escenarios

Guía de configuración paso a paso

Paso 1: Configuración de Fastn

Inicie sesión en su cuenta Fastn
Vaya a "Conectores" desde la barra lateral izquierda.
Active el/los servicio(s) que desee utilizar haciendo clic en activar.
Vaya a "Configuración" desde la barra lateral izquierda.
Haga clic en "Generar clave API" y guárdela en algún lugar local (por ejemplo, en un bloc de notas)
Haz clic en el botón copiar que existe en la barra superior (lado izquierdo de tu perfil)
Copia tu ID de espacio de trabajo y guárdalo también
Toda la configuración de Fastn ya está completa

Paso 2: Configuración del servidor

Opción 1: Utilizar la instalación de paquetes (recomendado)

Consulte la sección "Instalación del paquete" más arriba.

Opción 2: Configuración manual

Prerrequisitos

Python 3.10 o superior

Inicio rápido

macOS

# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server

# Install UV, create virtual environment, and install dependencies in one go
curl -LsSf https://astral.sh/uv/install.sh | sh && uv venv && source .venv/bin/activate && uv pip install -e .

# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID 

Ventanas

# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server

# Install UV, create a virtual environment, and install dependencies
# Option 1: Install UV using pip
python -m pip install uv
# Make sure to copy the installation path and add it to your Windows environment variables.

# Option 2: Install UV using PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e .

# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID 

Paso 3: Integración con asistentes de IA

Para la instalación del paquete (Opción 1)

Encuentre la ruta a su servidor fastn instalado:
- En macOS/Linux: which fastn-server
- En Windows: where fastn-server
Configure su asistente de IA con la ruta del paso 1.

Para instalación manual (Opción 2)

Integración con Claude en Mac OS

Abra la configuración de Claude:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Agregue la siguiente configuración (reemplace los marcadores de posición con sus valores reales):

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/path/to/your/fastn-server",
                "run",
                "fastn-server.py",
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

Integración con Cursor

Abrir la configuración del cursor
Haga clic en "MCP" en el menú de configuración
Haga clic en "Agregar nuevo"
Agregue un nombre para su servidor (por ejemplo, "fastn")
Seleccione "Comando" como tipo
Agregue el siguiente comando (reemplace los marcadores de posición con sus valores reales):

/path/to/your/uv --directory /path/to/your/fastn-server run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

Instrucciones detalladas de integración

Para Claude

Abra el archivo de configuración de Claude:
- Windows: notepad "%APPDATA%\Claude\claude_desktop_config.json" o code "%APPDATA%\Claude\claude_desktop_config.json"
- Mac: open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json o code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Agregue el JSON de configuración apropiado según su método de instalación.

Para el cursor

Abrir la configuración del cursor
Haga clic en "MCP" en el menú de configuración
Haga clic en "Agregar nuevo"
Agregue un nombre para su servidor (por ejemplo, "fastn")
Seleccione "Comando" como tipo
Utilice la configuración adecuada según su método de instalación

Solución de problemas

Error de estructura del paquete

Si encuentra un error como este durante la instalación:

ValueError: Unable to determine which files to ship inside the wheel using the following heuristics:
The most likely cause of this is that there is no directory that matches the name of your project (fastn).

Solución rápida:

Asegúrese de que pyproject.toml tenga la configuración de rueda:

[tool.hatch.build.targets.wheel]
packages = ["."]

Luego instala las dependencias:

uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"

Ejecutar el servidor:

uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

Explotación florestal

Los registros se generan con marca de tiempo, nivel y mensaje en el siguiente formato:

%(asctime)s - %(levelname)s - %(message)s

Apoyo

Si tiene preguntas, problemas o solicitudes de funciones, visite:

Documentación: https://docs.fastn.ai
Comunidad: https://community.fastn.ai

Licencia

Este proyecto está licenciado bajo los términos incluidos en el archivo LICENCIA .

Fastn Server

Integrations