Standard Metrics MCP Server

Se conecta a la API de Standard Metrics para habilitar el análisis impulsado por IA de datos de carteras de capital de riesgo.

GitHub

Documentación

Servidor MCP de Standard Metrics

[!WARNING] OBSOLETO: Nuestro servidor MCP local está obsoleto. Por favor, use nuestra nueva configuración MCP alojada en su lugar: Guía de configuración de MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta Claude Desktop y otros clientes compatibles con MCP a la API de Standard Metrics, permitiendo análisis impulsados por IA de los datos de su cartera de capital de riesgo.

Qué Hace Esto

Este servidor MCP permite a Claude acceder directamente a sus datos de Standard Metrics para:

Analizar el Rendimiento de la Cartera: Obtenga resúmenes completos de todas las empresas de su cartera
Consultar Métricas Financieras: Acceda a ingresos, crecimiento, tasa de consumo y otras métricas clave
Buscar y Filtrar: Encuentre empresas por sector, rendimiento o criterios personalizados
Generar Informes: Cree resúmenes financieros detallados y análisis de rendimiento
Seguir Tendencias: Monitoree métricas a lo largo del tiempo con análisis de datos históricos

Instalación

1. Obtenga sus Credenciales OAuth2 de Standard Metrics

Inicie sesión en su cuenta de Standard Metrics
En el menú de la izquierda, haga clic en Configuración
Haga clic en Configuración de Desarrollador
Haga clic en "Agregar Aplicación" en la esquina superior derecha
Complete el nombre y la descripción de la aplicación
Haga clic en "Crear Aplicación"
Copie su ID de Cliente y Secreto de Cliente y guárdelos de forma segura (¡no podrá ver el secreto nuevamente!)

2. Instale a través de Claude Desktop

Agregue lo siguiente a su archivo de configuración MCP de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Primero, encuentre su ruta de uvx ejecutando which uvx en su terminal, luego use esa ruta en la configuración:

{
  "mcpServers": {
    "standard-metrics": {
      "command": "/path/to/uvx",
      "args": ["smx-mcp"],
      "env": {
        "SMX_CLIENT_ID": "your_client_id_here",
        "SMX_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Reemplace /path/to/uvx con el resultado de which uvx y reemplace your_client_id_here y your_client_secret_here con sus credenciales OAuth2 reales.

Requisitos Previos

Si aún no lo tiene instalado, necesitará instalar el administrador de paquetes de Python uv primero:

macOS/Linux:

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

Windows:

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

3. Reinicie Claude Desktop

Cierre y vuelva a abrir Claude Desktop. Debería ver "Standard Metrics" aparecer en sus conexiones MCP.

Ejemplos de Uso

Una vez instalado, puede pedirle a Claude que analice los datos de su cartera:

Resumen de la Cartera

Show me a summary of my entire portfolio performance

Análisis de Empresa

What are the key metrics for Acme Corp over the last 12 months?

Comparación por Sector

Compare the revenue growth of all my SaaS companies

Análisis Financiero Detallado

Create a financial summary for company ID abc123 including burn rate and runway

Consultas Personalizadas

Find all companies with revenue growth above 50% and show their latest metrics

Datos Disponibles

El servidor MCP proporciona acceso a:

Tipo de Dato	Descripción
Empresas	Información y detalles de las empresas de la cartera
Métricas Financieras	Ingresos, gastos, tasas de crecimiento, tasa de consumo
Presupuestos y Proyecciones	Datos de presupuesto y proyecciones financieras
Columnas Personalizadas	Columnas de datos personalizados de su firma
Documentos	Informes cargados y documentos financieros
Notas	Notas internas y comentarios
Datos de Fondos	Información a nivel de fondo
Solicitudes de Información	Solicitudes de recopilación de datos enviadas a empresas
Informes de Información	Respuestas a solicitudes de información
Usuarios	Miembros del equipo en su firma

Métodos de Instalación Alternativos

Usando Docker

{
  "mcpServers": {
    "standard-metrics": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "SMX_CLIENT_ID=your_client_id_here",
        "-e", "SMX_CLIENT_SECRET=your_client_secret_here",
        "-p", "8000:8000",
        "quaestorapp/smx-mcp:latest"
      ]
    }
  }
}

Desarrollo Local

git clone https://github.com/Quaestor-Technologies/smx-mcp
cd smx-mcp
uv sync

Luego use la ruta local en su configuración de Claude Desktop:

{
  "mcpServers": {
    "standard-metrics": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.server"],
      "env": {
        "SMX_CLIENT_ID": "your_client_id_here",
        "SMX_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Ejecución con Docker

1. Ejecute con la Imagen Alojada (Recomendado)

Puede usar la imagen precompilada de Docker Hub para la configuración más rápida:

docker run --rm -it \
  -e SMX_CLIENT_ID=your_client_id_here \
  -e SMX_CLIENT_SECRET=your_client_secret_here \
  -p 8000:8000 \
  quaestorapp/smx-mcp:latest

Reemplace your_client_id_here y your_client_secret_here con sus credenciales OAuth2 reales de Standard Metrics.
El servidor estará disponible en http://localhost:8000.

2. Compile y Ejecute Localmente

Si desea compilar la imagen usted mismo (para desarrollo o personalización):

# Build the Docker image
docker build -t smx-mcp .

# Run the container
docker run --rm -it \
  -e SMX_CLIENT_ID=your_client_id_here \
  -e SMX_CLIENT_SECRET=your_client_secret_here \
  -p 8000:8000 \
  smx-mcp

Nuevamente, reemplace las variables de entorno con sus credenciales.

3. Usando Docker en Claude Desktop

Agregue esto a su configuración MCP de Claude Desktop para usar la imagen de Docker:

{
  "mcpServers": {
    "standard-metrics": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "SMX_CLIENT_ID=your_client_id_here",
        "-e", "SMX_CLIENT_SECRET=your_client_secret_here",
        "-p", "8000:8000",
        "quaestorapp/smx-mcp:latest"
      ]
    }
  }
}

Consejo:

La imagen alojada se actualiza automáticamente con cada versión.
Para desarrollo local, puede montar su código en el contenedor con -v $(pwd)/src:/app/src si desea recargas de código en vivo.

Solución de Problemas

Error de "Conexión Fallida"

Verifique que su ID de Cliente y Secreto de Cliente sean correctos
Asegúrese de que su aplicación OAuth2 esté activa en Standard Metrics
Verifique que Claude Desktop se haya reiniciado después de la configuración

Error de "No Se Encontraron Datos"

Confirme que su cuenta de Standard Metrics tenga datos de cartera
Verifique que su aplicación OAuth2 tenga los permisos necesarios
Pruebe una consulta más simple primero: "Lista mis empresas"

Problemas de Autenticación

Vuelva a verificar que sus credenciales no hayan expirado
Asegúrese de que no haya espacios adicionales en su configuración
Intente regenerar sus credenciales OAuth2 si es necesario

Herramientas Disponibles

Empresas

list_companies - Lista todas las empresas asociadas con su firma

page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

get_company - Obtiene una empresa específica por ID

company_id: El identificador único de la empresa (cadena, requerido)

search_companies - Busca empresas por varios criterios

name_contains: Filtra empresas que contengan este texto en su nombre (cadena, opcional)
sector: Filtra empresas por sector (cadena, opcional)
city: Filtra empresas por ciudad (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

Métricas Financieras

get_company_metrics - Obtiene métricas para una empresa específica

company_id: El identificador único de la empresa (cadena, requerido)
from_date: Fecha de inicio para métricas (formato AAAA-MM-DD) (fecha, opcional)
to_date: Fecha de fin para métricas (formato AAAA-MM-DD) (fecha, opcional)
category: Filtra por categoría de métrica (cadena, opcional)
cadence: Filtra por cadencia de métrica (diaria, mensual, etc.) (cadena, opcional)
include_budgets: Incluye métricas de presupuesto en los resultados (booleano, opcional, predeterminado: falso)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

get_metrics_options - Obtiene categorías y opciones de métricas disponibles

category_name: Filtra por nombre de categoría específico (cadena, opcional)
is_standard: Filtra por métricas estándar vs personalizadas (booleano, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

get_company_recent_metrics - Obtiene las métricas más recientes de una empresa

company_id: El identificador único de la empresa (cadena, requerido)
category: Filtra por categoría de métrica específica (cadena, opcional)
limit: Número máximo de métricas recientes a devolver (número, opcional, predeterminado: 10)

Análisis de Cartera

get_portfolio_summary - Obtiene un resumen completo de la cartera que incluye empresas, fondos y métricas clave

company_ids: IDs de empresas específicas a incluir (matriz de cadenas, opcional, si es Ninguno incluye todas las empresas)
max_companies: Número máximo de empresas para incluir métricas (número, opcional, si es Ninguno incluye todas)
include_metrics: Si se deben obtener métricas para cada empresa (booleano, opcional, predeterminado: verdadero)
metrics_per_company: Número de métricas recientes a obtener por empresa (número, opcional, predeterminado: 50)

get_company_performance - Obtiene datos completos de rendimiento para una empresa específica

company_id: El identificador único de la empresa (cadena, requerido)
months: Número de meses de datos históricos a incluir (número, opcional, predeterminado: 12)

get_company_financial_summary - Obtiene un resumen financiero de una empresa que incluye métricas clave a lo largo del tiempo

company_id: El identificador único de la empresa (cadena, requerido)
months: Número de meses de datos históricos a incluir (número, opcional, predeterminado: 12)

Presupuestos y Proyecciones

list_budgets - Lista todos los presupuestos asociados con su firma

company_slug: Filtra por slug de empresa (cadena, opcional)
company_id: Filtra por ID de empresa (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

Datos Personalizados

get_custom_columns - Obtiene datos de columnas personalizadas para empresas

company_slug: Filtra por slug de empresa (cadena, opcional)
company_id: Filtra por ID de empresa (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

get_custom_column_options - Obtiene todas las columnas personalizadas y sus opciones disponibles

page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

Documentos

list_documents - Lista todos los documentos asociados con su firma

company_id: Filtra por ID de empresa (cadena, opcional)
parse_state: Filtra por estado de análisis del documento (cadena, opcional)
from_date: Filtra documentos desde esta fecha (formato AAAA-MM-DD) (fecha, opcional)
to_date: Filtra documentos hasta esta fecha (formato AAAA-MM-DD) (fecha, opcional)
source: Filtra por fuente del documento (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

Fondos

list_funds - Lista todos los fondos asociados con la firma

page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

Solicitudes e Informes de Información

list_information_requests - Lista todas las solicitudes de información asociadas con la firma

name: Filtra por nombre de solicitud (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

list_information_reports - Lista todos los informes de información asociados con la firma

company_id: Filtra por ID de empresa (cadena, opcional)
information_request_id: Filtra por ID de solicitud de información (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

Notas

list_notes - Lista todas las notas asociadas con una empresa específica

company_slug: Filtra por slug de empresa (cadena, opcional)
company_id: Filtra por ID de empresa (cadena, opcional)
sort_by: Ordena notas por campo específico (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

get_company_notes_summary - Obtiene un resumen de notas para una empresa

company_id: El identificador único de la empresa (cadena, requerido)
recent_notes_limit: El número de notas recientes a devolver (número, opcional, predeterminado: 5, máximo: 100)

Usuarios

list_users - Lista todos los usuarios asociados con su firma

email: Filtra por correo electrónico de usuario (cadena, opcional)
page: Número de página para paginación (número, opcional, predeterminado: 1)
per_page: Resultados por página (número, opcional, predeterminado: 100, máximo: 100)

Soporte

Problemas con la API de Standard Metrics: Contacte con el soporte de Standard Metrics
Problemas con el servidor MCP: Abra un problema en GitHub
Problemas con Claude Desktop: Consulte la documentación de Claude Desktop