Holaspirit MCP Server

🚀 holaspirit-mcp-server

MCP（モデルコンテキストプロトコル）をサポートするサーバで、Holaspirit APIに接続できます。このサーバは、HolaspiritのAPIに対してMCP互換のアクセスを提供し、AIアシスタントが標準インターフェースを介してHolaspiritのデータとやり取りできるようにします。

✨ 主な機能

利用可能なツール：

• list_tasks - 組織内のすべてのタスクをリストする
• list_metrics - 組織内のすべての指標をリストする
• list_circles - 組織内のすべてのサークルをリストする
• get_circle - 特定のサークルの詳細情報を取得する
• list_roles - 組織内のすべての役割をリストする
• get_role - 特定の役割の詳細情報を取得する
• list_domains - 組織内のすべてのドメインをリストする
• list_policies - 組織内のすべてのポリシーをリストする
• list_meetings - 組織内のすべての会議をリストする
• get_meeting - 特定の会議の詳細情報を取得する

🚀 クイックスタート

📦 インストール

Smitheryを通じたインストール

Claude Desktopにholaspirit-mcp-serverを自動インストールするには、Smitheryにアクセスしてください：

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

手動インストール

npm install holaspirit-mcp-server

設定

• HOLASPIRIT_API_TOKEN：あなたのHolaspirit APIトークン

使用方法

MCPサーバの起動

直接実行：

npx holaspirit-mcp-server

または、Node.jsを使用してインストールされたモジュールを起動します。

クライアントのMCP設定jsonを編集する：

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

🔧 開発

利用可能なスクリプト

• npm run dev - ホットリロード機能付きで開発モードでサーバを起動する
• npm run build - 本番環境用にプロジェクトをビルドする
• npm run start - 本番サーバを起動する
• npm run lint - コードチェック（ESLintとPrettier）を実行する
• npm run fix - コードの問題を自動的に修正する
• npm run examples - サンプルスクリプトを実行する

コントリビューションガイド

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. テストとコードチェックを実行する：npm run lint
4. 変更をコミットする
5. ブランチにプッシュする
6. プルリクエストを提出する