holaspirit-mcp-server

holaspirit-mcp-server

Holaspirit APIにアクセスするMCP（Model Context Protocol）サーバーです。

このサーバーは、Holaspirit の API に MCP 互換でアクセスできるようにし、標準化されたインターフェースを通じて AI アシスタントが Holaspirit のデータを操作できるようにします。

機能

利用可能なツール：

• holaspirit_list_tasks - 組織内のすべてのタスクを一覧表示します
• holaspirit_list_metrics - 組織内のすべてのメトリクスを一覧表示します
• holaspirit_list_circles - 組織内のすべてのサークルを一覧表示します
• holaspirit_get_circle - 特定のサークルの詳細を取得します
• holaspirit_list_roles - 組織内のすべてのロールを一覧表示します
• holaspirit_get_role - 特定のロールの詳細を取得します
• holaspirit_list_domains - 組織内のすべてのドメインを一覧表示します
• holaspirit_list_policies - 組織内のすべてのポリシーを一覧表示します
• holaspirit_list_meetings - 組織内のすべてのミーティングを一覧表示します
• holaspirit_get_meeting - 特定のミーティングの詳細を取得します
• holaspirit_get_member_feed - メンバーのフィードを取得します
• holaspirit_get_tensions - ミーティングのテンションを取得します
• holaspirit_search_member - メールアドレスでメンバーを検索します

クイックスタート

インストール

Smithery 経由でインストールする

Smithery経由で、Claude Desktop に holaspirit-mcp-server を自動的にインストールするには：

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

手動インストール

npm install holaspirit-mcp-server

設定

環境変数を使用してサーバーを設定できます。次の 2 つの方法がサポートされています：

環境変数

• HOLASPIRIT_API_TOKEN：Holaspirit API トークン
• HOLASPIRIT_ORGANIZATION_ID：Holaspirit の組織 ID

.env ファイルを使用する

プロジェクトのルートに .env ファイルを作成します：

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

次に、.env を実際の値に編集します：

HOLASPIRIT_API_TOKEN=your_api_token_here
HOLASPIRIT_ORGANIZATION_ID=your_organization_id_here

使用方法

このサーバーは 2 つのトランスポートモードに対応しています：

Stdio トランスポート（デフォルト）

stdin/stdout 経由で通信する MCP クライアントで使用します：

npx holaspirit-mcp-server

HTTP トランスポート

最新の Streamable HTTP プロトコルを使用する Web クライアントまたは HTTP ベースの連携で使用します：

npx holaspirit-mcp-server --port 3000

HTTP サーバーは任意のパス（例：/、/mcp、/sse）で POST リクエストのみを受け付け、Streamable HTTP トランスポートプロトコルを使用します。

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

Stdio トランスポートの場合：

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

HTTP トランスポートの場合は、クライアントが次の URL に接続するように設定します：

• http://localhost:3000/（または任意のパス）

開発

利用可能なスクリプト

• 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. プルリクエストを作成します