Syucream Holaspirit MCP Server

🚀 holaspirit-mcp-server

A server implementing the MCP (Model Context Protocol) for accessing the Holaspirit API.

This server provides an MCP interface compatible with the Holaspirit API, allowing AI assistants to interact with your Holaspirit data through a standard interface.

✨ Features

Available tools:

• list_tasks - List all tasks in the organization
• list_metrics - List all metrics in the organization
• list_circles - List all circles in the organization
• get_circle - Get detailed information about a specific circle
• list_roles - List all roles in the organization
• get_role - Get detailed information about a specific role
• list_domains - List all domains in the organization
• list_policies - List all policies in the organization
• list_meetings - List all meetings in the organization
• get_meeting - Get detailed information about a specific meeting

🚀 Quick Start

📦 Installation

npm install holaspirit-mcp-server

Configuration

Create a .env file containing your Holaspirit API credentials:

HOLASPIRIT_API_TOKEN=your_api_token

💻 Usage Examples

Basic Usage

1. Start the MCP server:

npx holaspirit-mcp-server

2. To view example usage, refer to the examples directory. To run the examples:

# Set the required environment variables
export EXAMPLES_CLIENT_HOLASPIRIT_API_TOKEN=your_api_token
export EXAMPLES_CLIENT_HOLASPIRIT_ORGANIZATION_ID=your_organization_id

# Run the examples
npm run examples

🔧 Technical Details

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 - Perform code checks (ESLint and Prettier)
• npm run fix - Automatically fix code issues
• npm run examples - Run the example scripts

Contribution Guidelines

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