Servidor MCP Heimdall | PlugMCP
Saltar al contenido Del publicador
Documentación
Heimdall
Open Source Observability Platform for MCP Servers and AI Applications
Overview
Heimdall is a comprehensive observability platform designed for monitoring Model Context Protocol (MCP) servers and AI/LLM applications. Built on OpenTelemetry standards, it provides real-time tracing, metrics, and insights into your AI infrastructure.
Open Source Observability Platform for MCP Servers & Apps
Conecta cualquier herramienta a cualquier agente. Directorio MCP para quien no escribe servidores.
Producto
Directorio
Desarrolladores
Empresa
Estrellas 29
Herramientas —
Disponibilidad —
Key Features
🔍 Real-time Tracing - Track every tool call, resource access, and prompt execution
📊 Dashboard Analytics - Visualize latency, error rates, and usage patterns
🔌 Easy Integration - Simple SDK decorators for Python and JavaScript/TypeScript
🏠 Self-hosted - Run entirely on your own infrastructure
📈 OpenTelemetry Native - Built on industry-standard observability protocols
TODO
Architecture Currently we only support self-hosted deployment. The architecture is as follows:
┌─────────────────┐ OTLP/HTTP ┌─────────────────┐
│ MCP Server │ ──────────────────▶│ Heimdall │
│ + SDK │ Port 4318 │ Backend │
└─────────────────┘ └────────┬────────┘
│
│ REST API
│
┌────────▼────────┐
│ Heimdall │
│ Frontend │
│ Port 5173 │
└─────────────────┘
Quick Start
Prerequisites
Node.js 18+
Python 3.9+ (for Python SDK)
1. Start the Backend cd backend
npm install
npm run dev
2. Start the Frontend cd frontend
npm install
npm run dev
3. Create Organization and Project
Navigate to http://localhost:5173
Create an account with your email and password
Create an Organization - this groups your projects together
Create a Project - each project has a unique ID for trace collection
4. Get Your Configuration After creating your organization and project, go to Settings to find:
Organization ID - Your organization identifier
Project ID - Your project identifier
You'll need these IDs to configure the SDK.
SDK Integration Heimdall provides SDKs for instrumenting your MCP servers:
Python Example from hmdl import HeimdallClient, trace_mcp_tool
# Initialize client with your organization and project IDs
client = HeimdallClient(
endpoint="http://localhost:4318",
org_id="your-org-id", # From Settings page
project_id="your-project-id", # From Settings page
service_name="my-mcp-server",
environment="development"
)
@trace_mcp_tool()
def search_tool(query: str, limit: int = 10) -> dict:
return {"results": [], "query": query, "limit": limit}
result = search_tool("test", limit=5)
client.flush()
Note : Python SDK automatically captures parameter names using introspection. Inputs are displayed as named objects: {"query": "test", "limit": 5}.
JavaScript/TypeScript Example import { HeimdallClient, traceMCPTool } from 'hmdl';
// Initialize client with your organization and project IDs
const client = new HeimdallClient({
endpoint: "http://localhost:4318",
orgId: "your-org-id", // From Settings page
projectId: "your-project-id", // From Settings page
serviceName: "my-mcp-server",
environment: "development"
});
const searchTool = traceMCPTool(
async (query: string, limit: number = 10) => ({ results: [], query, limit }),
{ name: "search-tool", paramNames: ["query", "limit"] }
);
await searchTool("test", 5);
await client.flush();
Note : Use the paramNames option to display inputs as named objects (e.g., {"query": "test", "limit": 5}) instead of arrays (["test", 5]).
Using Environment Variables You can also configure the SDK using environment variables:
export HEIMDALL_ENDPOINT="http://localhost:4318"
export HEIMDALL_ORG_ID="your-org-id"
export HEIMDALL_PROJECT_ID="your-project-id"
export HEIMDALL_SERVICE_NAME="my-mcp-server"
export HEIMDALL_ENVIRONMENT="development"
export HEIMDALL_ENABLED="true"
Then simply initialize the client without arguments:
# Python
client = HeimdallClient()
// JavaScript/TypeScript
const client = new HeimdallClient();
Configuration
Environment Variables
Client Configuration Options
Wrapper/Decorator Options
trace_mcp_tool / traceMCPTool
observe (general-purpose)
Project Structure heimdall/
├── backend/ # OTLP receiver and API server
├── frontend/ # React dashboard
├── tests/ # SDK integration tests
├── QUICKSTART.md # Detailed setup guide
└── README.md # This file
heimdall-python/ # Python SDK
heimdall-js/ # JavaScript/TypeScript SDK
Running Tests Test the SDK integration with the backend:
# Python SDK test
cd tests
source .venv/bin/activate
python test_python_sdk.py
# JavaScript SDK test
cd tests
npm run test:js
Documentation
Contributing Contributions are welcome! Please feel free to submit a Pull Request.
Support & Contact
License This project is licensed under the MIT License - see the LICENSE file for details.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas ¿Cómo instalo Heimdall? Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Heimdall necesita una clave de API? Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Heimdall? Heimdall se ejecuta localmente por stdio.
¿Cuándo se comprobó Heimdall por última vez? Última comprobación: 2026-10-27. Open Source Observability Platform for MCP Servers & Apps
Las herramientas tienen descripción 0 de 6