Squad

🚀 Squad MCP サーバー

「モデルコンテキストプロトコル (MCP) サーバー」であり、AI 駆動の製品発見と戦略プラットフォームである Squad を、MCP に対応した任意の大規模言語モデル (LLM) アプリケーションに接続します。これにより、お気に入りの AI コラボレーションパートナーから直接、製品戦略アーティファクト（機会、ソリューション、成果、要件、知識、ワークスペース、フィードバック）を作成、照会、更新するための豊富なツールキットが提供されます。

このリポジトリには、Squad API とのやり取りに使用するクライアントツールを提供する @squadai/tools NPM パッケージのソースコードも含まれています。

🤔 なぜ必要なのか？

Squad MCP サーバーを使用すると、エディタやチャットウィンドウを離れることなく、1 つの会話フローで製品の調査、アイデア出し、計画を行うことができます。

✨ ツール

各ツールは MCP JSON スキーマ形式に準拠しているため、エージェントは入力と出力を自動的にイントロスペクトできます。

🚀 クイックスタート

1 · Squad API キーを取得する

1. https://meetsquad.ai で登録/ログインします。
2. 設定 → 開発者 → API キー を開きます。
3. キーを作成し、その値をコピーします。

2 · サーバーを実行する

環境に適したインストール方法を選択します。

方法 A – スタンドアロン実行ファイル（ローカル使用に推奨）

プロジェクトの GitHub リリースページ から最新のバイナリファイルをダウンロードし、直接実行します。

# Windows
squad-mcp.exe

# macOS / Linux — まずファイルを実行可能にする
chmod +x squad-mcp
./squad-mcp

通常の方法で環境変数を渡します。

SQUAD_API_KEY=<your-key> SQUAD_ENV=production ./squad-mcp

方法 B – Docker（本番環境に推奨）

# イメージをビルドする（1 回）
docker build -t mcp/meet-squad -f Dockerfile .

# stdio でサーバーを実行する
docker run --rm -i \
  -e SQUAD_API_KEY=<your-key> \
  mcp/meet-squad

方法 C – ソースコードから

git clone https://github.com/the-basilisk-ai/squad-mcp.git
cd squad-mcp
npm install
npm run build           # ./dist にトランスパイルする
node dist/index.js

📦 NPM パッケージ (@squadai/tools)

このリポジトリには、Squad API とのやり取りに使用する一連のツールを提供する NPM パッケージ @squadai/tools も含まれています。

🛠️ 環境変数

🧑💻 開発

npm install
npm run format      
npm run openapi:squad   # openapi/squad.json から型付きクライアントを再生成する
npm run build       
node dist/index.js

テストスイートは開発中です。貢献いただける方を歓迎します。