Fused MCP Agents

Los servidores MCP permiten a los LLM como Claude realizar solicitudes HTTP, conectándolas a API y código ejecutable. Creamos este repositorio para nosotros y para cualquiera que trabaje con datos, para que puedas transferir fácilmente cualquier código Python directamente a tu aplicación de escritorio de Claude.

Este repositorio ofrece un flujo de trabajo de cuaderno simple paso a paso para configurar servidores MCP con la aplicación de escritorio de Claude, todo en Python construido sobre funciones definidas por el usuario fusionadas (UDF).

Requisitos

• Python 3.11

• Última aplicación de Claude Desktop instalada (MacOS y Windows)

Si estás en Linux, la aplicación de escritorio no está disponible, por eso hemos creado un cliente simple que puedes usar para ejecutarla localmente también.

¡ No necesitas una cuenta de Fused para hacer esto! Todo esto se ejecutará en tu equipo local.

Related MCP server: computer-use-mcp

Instalación

• Clone este repositorio en cualquier directorio local y navegue hasta el repositorio:

  git clone https://github.com/fusedio/fused-mcp.git
  cd fused-mcp/

• Instalar uv si no lo tienes:

  macOS / Linux:

  curl -LsSf https://astral.sh/uv/install.sh | sh

  Ventanas:

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Pruebe el cliente solicitando su información:

  uv run main.py -h

• Comience siguiendo nuestro cuaderno de introducción fused_mcp_agents.ipynb en su IDE local favorito para configurarlo y luego avance hacia el cuaderno más avanzado para crear sus propios agentes y funciones.

Estructura del repositorio

Este repositorio está construido sobre MCP Server y Fused UDF, que son funciones de Python que se pueden ejecutar desde cualquier lugar.

Soporte y comunidad

¡No dudes en unirte a nuestro servidor de Discord si quieres ayuda para desbloquearte!

A continuación se muestran algunos pasos comunes para depurar la configuración:

• Ejecutar uv run main.py -h debería devolver algo como esto:

• Es posible que necesites pasar las rutas globales de algunas funciones a Claude_Desktop_Config.json . Por ejemplo, por defecto, solo pasamos uv :

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": ["..."]
        }

    }
}

Pero es posible que necesites pasar la ruta completa a uv , que puedes simplemente pasar a common.generate_local_mcp_config en el cuaderno:

# in fused_mcp_agents.ipynb
import shutil 

common.generate_local_mcp_config(
    config_path=PATH_TO_CLAUDE_CONFIG,
    agents_list = ["get_current_time"],
    repo_path= WORKING_DIR,
    uv_path=shutil.which('uv'),
)

Lo que crearía una configuración como esta:

{
    "mcpServers": {
        "qgis": {
            "command": "/Users/<YOUR_USERNAME>/.local/bin/uv",
            "args": ["..."]
        }

    }
}

• Si Claude se ejecuta sin mostrar ninguna herramienta conectada, consulte los documentos de MCP para solucionar problemas de configuración de Claude Desktop.

Contribuir

Siéntete libre de abrir PR para agregar tus propios UDF a udfs/ para que otros también puedan jugar con ellos localmente!

Usando un cliente Claude local (sin la aplicación Claude Desktop)

Si no puede instalar la aplicación Claude Desktop (por ejemplo, en Linux), proporcionamos un pequeño ejemplo de interfaz de cliente local para usar Claude con el servidor MCP configurado en este repositorio:

NOTA: Necesitarás una clave API para Claude aquí, ya que no usarás la aplicación de escritorio.

• Crear una cuenta de consola antrópica

• Crear una clave API antrópica

• Crear un .env :

  touch .env

• Agregue su clave como ANTHROPIC_API_KEY dentro del .env :

  # .env
  ANTHROPIC_API_KEY = "your-key-here"

• Inicie el servidor MCP:

  uv run main.py --agent get_current_time

• En otra sesión de terminal, inicie el cliente local, apuntando a la dirección del servidor:

  uv run client.py http://localhost:8080/sse