Holaspirit Mcp Server

Overview

What is Holaspirit MCP Server?

Holaspirit MCP Server is a powerful tool designed to facilitate seamless access to the Holaspirit platform. It serves as a middleware that connects various applications and services, allowing users to interact with Holaspirit's features and functionalities efficiently. This server is particularly useful for developers looking to integrate Holaspirit into their existing systems or create new applications that leverage Holaspirit's capabilities.

Features of Holaspirit MCP Server

Easy Integration: The Holaspirit MCP Server simplifies the process of connecting to the Holaspirit platform, making it easier for developers to integrate its features into their applications.
Middleware Functionality: Acts as a bridge between different services, ensuring smooth communication and data exchange.
Robust API Support: Offers a comprehensive API that allows developers to access various functionalities of Holaspirit, enhancing the overall user experience.
Open Source: Being a public repository, developers can contribute to its development, customize it according to their needs, and benefit from community support.
Documentation and Community Support: Comes with extensive documentation and an active community, making it easier for users to find help and resources.

How to Use Holaspirit MCP Server

Installation: Begin by installing the Holaspirit MCP Server via npm. You can do this by running the following command in your terminal:
```
npm install holaspirit-mcp-server
```
Configuration: After installation, configure the server by setting up the necessary environment variables and configuration files to connect to your Holaspirit account.
Start the Server: Launch the server using the command:
```
npm start
```
Access the API: Once the server is running, you can access the API endpoints to interact with Holaspirit's features. Refer to the documentation for detailed information on available endpoints and their usage.
Develop Your Application: Use the API to build your application, integrating Holaspirit's functionalities as needed.

Frequently Asked Questions

Q1: What is the purpose of the Holaspirit MCP Server?

A1: The Holaspirit MCP Server is designed to provide developers with an easy way to access and integrate Holaspirit's features into their applications.

Q2: Is Holaspirit MCP Server free to use?

A2: Yes, the Holaspirit MCP Server is open-source and available for free on npm.

Q3: Where can I find the documentation for Holaspirit MCP Server?

A3: Documentation can be found on the npm package page and within the repository.

Q4: Can I contribute to the Holaspirit MCP Server?

A4: Absolutely! As an open-source project, contributions are welcome. You can fork the repository, make changes, and submit a pull request.

Q5: What technologies does Holaspirit MCP Server use?

A5: The server is built using Node.js, allowing it to handle asynchronous operations efficiently and providing a robust environment for API interactions.

Details

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.

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

Fork the repository
Create your feature branch
Run tests and linting: npm run lint
Commit your changes
Push to the branch
Create a Pull Request

{ "mcpServers": { "holaspirit-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/metorial/mcp-container--syucream--holaspirit-mcp-server--holaspirit-mcp-server", "npm run start" ], "env": { "HOLASPIRIT_API_TOKEN": "holaspirit-api-token" } } } }