Interact with Holaspirit MCP Server

Overview

The Holaspirit MCP server is an implementation of a Model Context Protocol (MCP) provider intended for development and integration work. It lets applications and LLM-based tooling request curated context (organization, teams, documents, attachments, etc.) from a Holaspirit-oriented backend, using a stable HTTP interface that mirrors the MCP concept.

For integration engineers and developers building LLM workflows, this server is useful as a local test harness and lightweight context provider. You can run it locally or in containerized environments to prototype how your model consumes organizational context, validate authentication flows, and iterate on caching or filtering logic before wiring up production data sources.

Features

• Simple HTTP server implementing MCP-style endpoints for serving model context
• Configurable via environment variables or a small configuration file
• Docker-friendly for fast local testing and CI usage
• Lightweight, intended for local development, testing and integration validation
• Logs and basic health/status endpoints to support automation and observability

Installation / Configuration

Clone the repository and install dependencies:

git clone https://github.com/syucream/holaspirit-mcp-server.git
cd holaspirit-mcp-server
# using npm
npm ci
# or using yarn
yarn install

Build and start the server in development:

# build (if applicable) and start
npm run build
npm start

Run with Node directly (example):

NODE_ENV=development PORT=8080 npm start

Docker

# build the container
docker build -t holaspirit-mcp-server:latest .

# run the container (exposes port 8080 by default)
docker run -it --rm -p 8080:8080 \
  -e PORT=8080 \
  -e LOG_LEVEL=info \
  holaspirit-mcp-server:latest

Recommended environment variables

Example .env file

PORT=8080
HOST=0.0.0.0
LOG_LEVEL=info
MCP_API_KEY=your_dev_api_key_here
CACHE_TTL=300

Systemd unit (example)

[Unit]
Description=Holaspirit MCP Server
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/holaspirit-mcp-server
EnvironmentFile=/opt/holaspirit-mcp-server/.env
ExecStart=/usr/bin/npm start
Restart=on-failure

[Install]
WantedBy=multi-user.target

Available Resources

The repository contains:

• Source code for the MCP server (Express/Koa or similar Node server)
• Dockerfile to build a container image for local testing and CI
• Example configuration / .env file to get started quickly
• Tests and example requests (check the examples/ or tests/ folders)
• README and CONTRIBUTING notes describing dev workflow

Check the repo root for files such as:

• Dockerfile
• package.json (scripts for build/start/test)
• config.example.* or .env.example
• examples/ or docs/ for sample requests

Use Cases

1. Local development and rapid prototyping

   • Run the server locally in a container while building a connector that consumes organizational context for an LLM assistant.
   • Example:

     # start server
     docker run -p 8080:8080 -e MCP_API_KEY=devkey holaspirit-mcp-server
     
     # request context (replace PATH with the server's MCP endpoint)
     curl -H "Authorization: Bearer devkey" http://localhost:8080/mcp/v1/context
     

   • Use this to iterate on payload shapes, caching, and filtering before integrating with production systems.

2. CI integration tests

   • Start the MCP server as a test dependency in CI to validate end-to-end flows that depend on model context.
   • Example (GitHub Actions snippet):

     services:
       mcp-server:
         image: ghcr.io/your-org/holaspirit-mcp-server:latest
         ports: ['8080:8080']
         options: >-
           --env MCP_API_KEY=ci_key
     

3. Mocking and contract validation

   • Use the server to provide deterministic responses for contract testing between backend services and