BIP Skills MCP

bip-skills-mcp

エージェントスキル（SKILL.md と、任意の references/、scripts/、assets/ を含むフォルダー）を、あらゆる MCP クライアント（Claude Desktop、Claude Code、Cursor、VS Code…）に提供する MCP サーバーです。

bip-xsl-hardening というスキルが 1 つ付属しています（Oracle BI Publisher の HTML ダッシュボード向け XSLT 1.0 パターン：ロケールに依存しないグループ化、複数形式の XML、適応型フォールバック、EXSLT を使わない日付演算）。SKILLS_DIR に独自のフォルダーを指定すれば、ご利用のマシンにあるプライベートスキルを提供できます。スキルが外部にアップロードされることはありません。

ツール

ツール	目的
skills_list	スキル（名前、説明、ソース）の一覧を表示します。任意で query フィルターを指定できます。
skills_get	スキルの SKILL.md 全文を取得します。
skills_list_files	スキルに含まれるファイルとサイズの一覧を表示します。
skills_read_file	スキルのテキストファイルを 1 つ読み取ります（パストラバーサル対策済み、最大 2 MB）。

各スキルはリソース skill://<name>/SKILL.md としても公開されます。すべてのツールは読み取り専用です。

インストール

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "@2fizzle/bip-skills-mcp"],
      "env": { "SKILLS_DIR": "C:\\path\\to\\my\\skills" }
    }
  }
}

変数	効果
SKILLS_DIR	追加のスキルフォルダーを指定します。Windows では ;、それ以外では : で区切ります。最大 3 階層まで検索します。同じ名前のローカルスキルは、付属スキルより優先されます。
SKILLS_NO_BUNDLED=1	SKILLS_DIR のみを提供します。

Node.js 20.3 以降が必要です。

リモートでの利用（Streamable HTTP）

TRANSPORT=http を設定すると、/mcp で HTTP 経由の MCP を提供します（ヘルスチェックは /health）。

変数	デフォルト	効果
TRANSPORT	stdio	http を指定すると HTTP サーバーが起動します。
PORT	3000	リッスンするポートです。
HOST	127.0.0.1。ただし、PORT がホストによって設定されている場合は 0.0.0.0	バインドアドレスです。
ALLOWED_HOSTS	—	0.0.0.0 にバインドする場合に、Host ヘッダーで許可する公開ホスト名をカンマ区切りで指定します（DNS リバインディング対策）。
MCP_AUTH_TOKEN	—	設定すると、すべての /mcp リクエストで Authorization: Bearer <token> の送信が必要になります。提供するスキルが公開されている場合に限り、未設定のままにしてください。

ローカルで実行する場合：

TRANSPORT=http npx -y @2fizzle/bip-skills-mcp
# → http://127.0.0.1:3000/mcp

デプロイ

• Render：New → Blueprint → このリポジトリ（render.yaml を使用）。トークンを設定する場合はダッシュボードで MCP_AUTH_TOKEN を設定し、ALLOWED_HOSTS をサービスのホスト名に変更します。
• 任意の Docker ホスト（Fly.io、Railway、Cloud Run…）：docker build -t bip-skills-mcp . を実行し、続けて -p 3000:3000 -e ALLOWED_HOSTS=your.host を指定して実行します。

ホストされたインスタンスが提供するのは付属スキルのみです。SKILLS_DIR はローカルフォルダーを参照するため、ホスト環境では効果がありません。

接続

• Claude（ウェブ、デスクトップ、モバイル）：Settings → Connectors → Add custom connector → https://<your-host>/mcp。カスタムコネクターが対応しているのは認証なし、または OAuth を使うサーバーであり、静的なベアラートークンには対応していません。この方法では MCP_AUTH_TOKEN を未設定にしてください。
• Claude Code：claude mcp add --transport http bip-skills https://<your-host>/mcp --header "Authorization: Bearer <token>"

開発

npm install
npm run build
npm run smoke        # stdio: starts the server and checks every tool
npm run smoke:http   # HTTP: checks /health, bearer auth and every tool

ライセンス

MIT