Holaspirit Servidor Mcp

¿Qué es el Servidor MCP de Holaspirit?

El Servidor MCP de Holaspirit es una herramienta poderosa diseñada para facilitar el acceso sin problemas a la plataforma Holaspirit. Actúa como un middleware que conecta diversas aplicaciones y servicios, permitiendo a los usuarios interactuar con las características y funcionalidades de Holaspirit de manera eficiente. Este servidor es particularmente útil para los desarrolladores que buscan integrar Holaspirit en sus sistemas existentes o crear nuevas aplicaciones que aprovechen las capacidades de Holaspirit.

Características del Servidor MCP de Holaspirit

• Integración Fácil: El Servidor MCP de Holaspirit simplifica el proceso de conexión a la plataforma Holaspirit, facilitando a los desarrolladores la integración de sus características en sus aplicaciones.
• Funcionalidad de Middleware: Actúa como un puente entre diferentes servicios, asegurando una comunicación y un intercambio de datos fluidos.
• Soporte Robusto de API: Ofrece una API completa que permite a los desarrolladores acceder a diversas funcionalidades de Holaspirit, mejorando la experiencia general del usuario.
• Código Abierto: Al ser un repositorio público, los desarrolladores pueden contribuir a su desarrollo, personalizarlo según sus necesidades y beneficiarse del apoyo de la comunidad.
• Documentación y Soporte Comunitario: Viene con documentación extensa y una comunidad activa, lo que facilita a los usuarios encontrar ayuda y recursos.

Cómo Usar el Servidor MCP de Holaspirit

1. Instalación: Comienza instalando el Servidor MCP de Holaspirit a través de npm. Puedes hacerlo ejecutando el siguiente comando en tu terminal:

   npm install holaspirit-mcp-server
   

2. Configuración: Después de la instalación, configura el servidor configurando las variables de entorno necesarias y los archivos de configuración para conectarte a tu cuenta de Holaspirit.

3. Iniciar el Servidor: Lanza el servidor usando el comando:

   npm start
   

4. Acceder a la API: Una vez que el servidor esté en funcionamiento, puedes acceder a los puntos finales de la API para interactuar con las características de Holaspirit. Consulta la documentación para obtener información detallada sobre los puntos finales disponibles y su uso.

5. Desarrolla Tu Aplicación: Utiliza la API para construir tu aplicación, integrando las funcionalidades de Holaspirit según sea necesario.

Preguntas Frecuentes

P1: ¿Cuál es el propósito del Servidor MCP de Holaspirit?

R1: El Servidor MCP de Holaspirit está diseñado para proporcionar a los desarrolladores una forma fácil de acceder e integrar las características de Holaspirit en sus aplicaciones.

P2: ¿Es gratuito el uso del Servidor MCP de Holaspirit?

R2: Sí, el Servidor MCP de Holaspirit es de código abierto y está disponible de forma gratuita en npm.

P3: ¿Dónde puedo encontrar la documentación del Servidor MCP de Holaspirit?

R3: La documentación se puede encontrar en la página del paquete npm y dentro del repositorio.

P4: ¿Puedo contribuir al Servidor MCP de Holaspirit?

R4: ¡Absolutamente! Como proyecto de código abierto, se aceptan contribuciones. Puedes bifurcar el repositorio, hacer cambios y enviar una solicitud de extracción.

P5: ¿Qué tecnologías utiliza el Servidor MCP de Holaspirit?

R5: El servidor está construido utilizando Node.js, lo que le permite manejar operaciones asíncronas de manera eficiente y proporcionar un entorno robusto para interacciones con la API.

holaspirit-mcp-server

A MCP(Model Context Protocol) server that accesses to Holaspirit API.

This server provides MCP-compatible access to Holaspirit's API, allowing AI assistants to interact with your Holaspirit data through a standardized interface.

<a href="https://glama.ai/mcp/servers/7tn35lri9w"><img width="380" height="200" src="https://glama.ai/mcp/servers/7tn35lri9w/badge" alt="Holaspirit Server MCP server" /></a>

Features

Available tools:

• holaspirit_list_tasks - List all tasks in the organization
• holaspirit_list_metrics - List all metrics in the organization
• holaspirit_list_circles - List all circles in the organization
• holaspirit_get_circle - Get details of a specific circle
• holaspirit_list_roles - List all roles in the organization
• holaspirit_get_role - Get details of a specific role
• holaspirit_list_domains - List all domains in the organization
• holaspirit_list_policies - List all policies in the organization
• holaspirit_list_meetings - List all meetings in the organization
• holaspirit_get_meeting - Get details of a specific meeting
• holaspirit_get_member_feed - Get member feed
• holaspirit_get_tensions - Get tensions for a meeting or meetings
• holaspirit_search_member - Search for a member by email

Quick Start

Installation

Installing via Smithery

To install holaspirit-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install holaspirit-mcp-server --client claude

Manual Installation

npm install holaspirit-mcp-server

Configuration

You can configure the server using environment variables. Two methods are supported:

Environment Variables

• HOLASPIRIT_API_TOKEN: Your Holaspirit API token
• HOLASPIRIT_ORGANIZATION_ID: Your Holaspirit organization ID

Using .env File

Create a .env file in the project root:

### Copy the example file
cp .env.example .env

Then edit .env with your actual values:

HOLASPIRIT_API_TOKEN=your_api_token_here
HOLASPIRIT_ORGANIZATION_ID=your_organization_id_here

Usage

The server supports two transport modes:

Stdio Transport (Default)

For use with MCP clients that communicate via stdin/stdout:

npx holaspirit-mcp-server

HTTP Transport

For use with web clients or HTTP-based integrations using the latest Streamable HTTP protocol:

npx holaspirit-mcp-server --port 3000

The HTTP server accepts POST requests only on any path (e.g., /, /mcp, /sse) and uses the Streamable HTTP transport protocol.

Edit MCP configuration json for your client:

For stdio transport:

...
    "holaspirit": {
      "command": "npx",
      "args": [
        "-y",
        "holaspirit-mcp-server"
      ],
      "env": {
        "HOLASPIRIT_API_TOKEN": "<your token>",
        "HOLASPIRIT_ORGANIZATION_ID": "<your org id>"
      }
    },
...

For HTTP transport, configure your client to connect to:

• http://localhost:3000/ (or any path)

Development

Available Scripts

• npm run dev - Start the server in development mode with hot reloading
• npm run build - Build the project for production
• npm run start - Start the production server
• npm run lint - Run linting checks (ESLint and Prettier)
• npm run fix - Automatically fix linting issues
• npm run examples - Run the example scripts

Contributing

1. Fork the repository
2. Create your feature branch
3. Run tests and linting: npm run lint
4. Commit your changes
5. Push to the branch
6. Create a Pull Request