tacit-mcp

AIアシスタントをTacitのビルデジタルツインに接続するMCPサーバーです。建物、設備、センサー、ゾーンに関する質問を自然言語で行うことができます。

Claude Desktop、Claude Code、Cursor、Windsurf、およびMCP互換クライアントで動作します。

機能

4つの読み取り専用ツール:

ツール	用途
`tacit_list_sites`	APIキーでアクセス可能な建物の一覧を表示
`tacit_graphql`	ビルナレッジグラフ（Brick準拠）をクエリ
`tacit_timeseries`	過去のセンサーデータを取得
`tacit_list_files`	サイトのドキュメントとファイルの一覧を表示

GraphQLツールには完全なスキーマ参照が含まれているため、AIモデルは個別のドキュメントなしでクエリを作成できます。

クイックスタート

オプションA: npx（推奨 — インストール不要）

npx -y @tacit/mcp-server

MCPクライアントで指定するだけです（以下の設定を参照）。クローンやビルドは不要です。

オプションB: クローンとビルド

git clone https://github.com/ucl-sbde/tacit-mcp.git
cd tacit-mcp
npm install
npm run build

Tacit APIキーが必要です。app.betacit.comのダッシュボードにあるSite Settings > API Keysから取得してください。

接続方法

1. Stdioトランスポート（ローカル、デフォルト）

標準的な方法です。MCPクライアントがサーバーを子プロセスとして起動します。個人のマシンでの使用に最適です。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) を編集します：

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

プロジェクト内の .mcp.json に追加します：

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

2. Streamable HTTPトランスポート（リモート）

サーバーを永続的なHTTPサービスとして実行します。チームでの利用、クラウドデプロイ、ユーザーがローカルにNode.jsをインストールできない環境に最適です。

# Start the HTTP server
TACIT_API_KEY=your-api-key npm run start:http

# Or with npx
TACIT_API_KEY=your-api-key npx --package @tacit/mcp-server tacit-mcp-http

サーバーはデフォルトで http://0.0.0.0:3001/mcp でリッスンします。

MCPクライアントからの接続

ベアラートークンを使用して、クライアントからサーバーURLを指定します：

{
  "mcpServers": {
    "tacit": {
      "type": "streamable-http",
      "url": "https://your-host:3001/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

HTTP設定

変数	デフォルト	説明
`PORT`	`3001`	リッスンするポート
`HOST`	`0.0.0.0`	バインドするアドレス
`MCP_PATH`	`/mcp`	MCPエンドポイントパス
`TACIT_API_KEY`		APIキーモードで必須
`TACIT_OAUTH_ISSUER`		OAuth 2.1モードを有効にする場合に設定

ヘルスチェック

GET /health → { "status": "ok", "transport": "streamable-http", "sessions": 3 }

3. OAuth 2.1（エンタープライズ）

APIキーを管理する代わりに、ユーザーがTacitのログインフローを通じて認証を行う本番環境向け：

TACIT_OAUTH_ISSUER=https://app.betacit.com npm run start:http

これにより以下が可能になります：

動的クライアント登録 — MCPクライアントが自動的に登録されます
認可コード + PKCE — ユーザーはTacitのWeb UIを通じてログインします
トークンリフレッシュ — 再認証なしでセッションを維持します
トークン取り消し — クリーンなセッション終了

OAuthをサポートするMCPクライアント（Claude Desktopなど）は、.well-known/oauth-authorization-server メタデータエンドポイントを介して認証設定を自動的に検出します。

4. Docker

docker run -p 3001:3001 -e TACIT_API_KEY=your-api-key tacit/mcp-server

上記のHTTPトランスポート設定を使用して接続してください。

試してみる

接続後、AIアシスタントに以下のように質問してみてください：

「私のビルサイトをすべてリストアップして」
「Tower WestにあるAHUは何ですか？」
「AHU-001の温度センサーを見せて」
「過去24時間の給気温度データを取得して」
「ロビーゾーンに供給している設備は何ですか？」

環境変数

変数	必須	デフォルト	説明
`TACIT_API_KEY`	はい (stdio/HTTP)		Tacit APIキー
`TACIT_API_URL`	いいえ	`https://app.betacit.com`	APIベースURL（セルフホスト用）
`TACIT_OAUTH_ISSUER`	いいえ		OAuth発行者URL（OAuth 2.1モードを有効化）
`PORT`	いいえ	`3001`	HTTPサーバーポート
`HOST`	いいえ	`0.0.0.0`	HTTPサーバーバインドアドレス
`MCP_PATH`	いいえ	`/mcp`	HTTP MCPエンドポイントパス

開発

npm run dev       # watch mode — stdio transport
npm run dev:http  # watch mode — HTTP transport
npm run build     # compile TypeScript
npm start         # run stdio transport
npm run start:http # run HTTP transport

ライセンス

MIT

Tacit MCP