Servidor MCP de Massive.com

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la API completa de datos financieros de Massive.com a través de una interfaz compatible con LLM.

En lugar de exponer una herramienta por endpoint, este servidor ofrece al LLM tres herramientas componibles — search, call y query — que cubren toda la superficie de la API de Massive.com. Los datos pueden almacenarse en una base de datos SQLite en memoria y enriquecerse con funciones financieras integradas.

Herramientas

Funciones integradas

Las funciones se pueden aplicar a los resultados de la API o a la salida de consultas mediante el parámetro apply en call_api y query_data. Usa search_endpoints con scope="functions" para descubrirlas.

Cobertura de datos

El servidor indexa dinámicamente todos los endpoints de la API de Massive.com al iniciarse desde llms.txt, por lo que se mantiene automáticamente sincronizado con la API. La cobertura incluye:

• Agregados de acciones, opciones, divisas, criptomonedas y futuros

• Operaciones y cotizaciones en tiempo real e históricas

• Instantáneas de mercado, ganadores/perdedores

• Detalles de tickers y datos de referencia

• Dividendos, splits, OPIs

• Fundamentos financieros

• Calificaciones de analistas y noticias (Benzinga)

• Rendimientos del Tesoro, datos de inflación

• Estado del mercado y días festivos

Related MCP server: Dingo MCP Server

Instalación

Requisitos previos

• Python 3.12+

• Una clave de API de Massive.com [![Button]][Link]

• Astral UV (v0.4.0+)

Claude Code

Primero, instala Claude Code

npm install -g @anthropic-ai/claude-code

Instala el servidor MCP y luego regístralo en Claude Code:

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

Para actualizar a una nueva versión más adelante:

uv tool upgrade mcp_massive

Este comando instalará el servidor MCP en tu proyecto actual. Si deseas instalarlo globalmente, puedes ejecutar el comando con la bandera -s <scope>. Consulta claude mcp add --help para más opciones.

Para iniciar Claude Code, ejecuta claude en tu terminal.

• Si es la primera vez que lo usas, sigue las instrucciones de configuración para autenticarte

También puedes ejecutar claude mcp add-from-claude-desktop si el servidor MCP ya está instalado para Claude Desktop.

Claude Desktop

1. Sigue las instrucciones de instalación de MCP para Claude Desktop para completar la instalación inicial y encontrar tu archivo de configuración.

2. Instala el servidor:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

3. Encuentra la ruta del binario instalado:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. Añade el servidor a tu configuración de Claude Desktop. Reemplaza <path_to_mcp_massive> con la salida del paso anterior y completa los campos restantes.

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

Configuración

Variables de entorno

Transporte

De forma predeterminada, se utiliza el transporte STDIO. El transporte se puede configurar mediante el argumento de CLI --transport o la variable de entorno MCP_TRANSPORT (el argumento de CLI tiene prioridad).

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

Ejemplos de uso

Una vez integrado, puedes pedirle a Claude que acceda a los datos de Massive.com:

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

Desarrollo

Ejecución local

Comprueba que tienes instalados los Requisitos previos.

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

Instala desde tu repositorio local y luego referencia el binario directamente:

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Depuración

Para depuración y pruebas, recomendamos usar el Inspector MCP:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

Esto iniciará una interfaz de navegador donde podrás interactuar directamente con tu servidor MCP y ver la entrada/salida de cada herramienta.

Selecciona el tipo de transporte STDIO en la interfaz de usuario del navegador con el comando uv y run mcp_massive como argumentos.

Linting de código

Este proyecto utiliza just para tareas comunes de desarrollo. Para hacer linting de tu código antes de enviar un PR:

just lint

Esto ejecutará ruff format y ruff check --fix para formatear automáticamente tu código y corregir problemas de linting.

Enlaces

• Documentación de Massive.com

• Model Context Protocol

• SDK de Python para MCP

Política de privacidad

Este servidor MCP interactúa con la API de Massive.com para obtener datos de mercado. Todas las solicitudes de datos están sujetas a la política de privacidad y los términos de servicio de Massive.com.

• Política de privacidad de Massive.com: https://massive.com/legal/privacy

• Manejo de datos: Este servidor no almacena ni guarda en caché ningún dato del usuario. Todas las solicitudes se envían directamente a la API de Massive.com.

• Clave de API: Tu clave de API de Massive.com se utiliza únicamente para autenticar las solicitudes a su API.

• User-Agent: Las solicitudes de API incluyen una cadena User-Agent que contiene la versión del servidor MCP (p. ej., MCP-Massive/0.x.y). No se incluye información de identificación personal.

Contribución

Si encontraste un error o tienes una idea para una nueva función, por favor discútelo primero con nosotros enviando un nuevo issue. Responderemos a los issues en un plazo máximo de 3 semanas. También estamos abiertos a voluntarios si deseas enviar un PR para cualquier issue abierto, pero por favor discútelo con nosotros de antemano. Los PR que no estén vinculados a un issue existente o discutidos con nosotros de antemano generalmente serán rechazados.