Skip to main content
Glama
README.md
# dads-mcp

An unofficial MCP server for the [Digital Agency Design System (DADS)](https://design.digital.go.jp/dads/) of Japan. It lets AI assistants read DADS guidelines, component code (HTML / React) and design tokens. Not affiliated with the Digital Agency. Guideline text is not bundled in this repository; it is fetched into a local cache on your machine, and every answer includes the source URL.

---

デジタル庁デザインシステム(DADS)のガイドライン・コンポーネントのコード・デザイントークンを、AI(Claude Code、Claude Desktop など MCP に対応したアプリ)から引けるようにする MCP サーバーです。

非公式です。デジタル庁とは無関係です。

## できること

| ツール | 内容 |
| --- | --- |
| `list_components` | コンポーネントの一覧 |
| `get_component` | 1 つのコンポーネントの説明(概要・使い方・アクセシビリティ)と HTML / CSS / React のコード |
| `list_foundations` | 基本ルール(色・文字・余白・レイアウトなど)の項目一覧 |
| `get_foundation` | 基本ルールの本文 |
| `get_tokens` | デザイントークン(色・文字・角丸・影)の CSS 変数か JSON と、読み込み方法 |
| `search` | ガイドライン全体のキーワード検索 |
| `get_page` | 上以外の任意のページの本文 |

## 使い方

Node.js 22 以上が必要です。

Claude Code:

```sh
claude mcp add dads -- npx -y github:darthrommy/dads-mcp
```

Claude Desktop(`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "dads": { "command": "npx", "args": ["-y", "github:darthrommy/dads-mcp"] }
  }
}
```

初回は、インストール時のビルドと、デジタル庁のサイト・GitHub からのデータ取得に時間がかかります。データは次の場所に保存されます。

- macOS / Linux: `~/.cache/dads-mcp`(`XDG_CACHE_HOME` があればその下)
- Windows: `%LOCALAPPDATA%\dads-mcp`
- 環境変数 `DADS_MCP_CACHE_DIR` で変更できます

### データの更新と確認

```sh
npx -y github:darthrommy/dads-mcp update   # 最新のデータを取得
npx -y github:darthrommy/dads-mcp status   # 保存場所・取得日時・件数を表示
```

自動では更新しません。取得から 30 日たつと、ツールの返答に更新を勧める一文が付きます。

### 頼み方の例

- 「DADS のコンポーネントを使って、ゼミの紹介ページを HTML で作って」
- 「DADS の色と文字のトークンで、発表スライドの配色とフォントを決めて」
- 「DADS のボタンのアクセシビリティの注意点を教えて」

## ライセンス

このリポジトリのコードは [MIT License](./LICENSE) です。

このツールが取得するデータは次のとおりです。

| データ | 提供元 | ライセンス |
| --- | --- | --- |
| HTML 版コンポーネント | [digital-go-jp/design-system-example-components-html](https://github.com/digital-go-jp/design-system-example-components-html) | MIT |
| React 版コンポーネント | [digital-go-jp/design-system-example-components-react](https://github.com/digital-go-jp/design-system-example-components-react) | MIT |
| デザイントークン | [@digital-go-jp/design-tokens](https://github.com/digital-go-jp/design-tokens) | MIT |
| ガイドライン本文 | [デジタル庁デザインシステムβ版](https://design.digital.go.jp/dads/) | サイト上に明記なし |

- ガイドライン本文はこのリポジトリに含めず、使う人の手元で取得してキャッシュします。
- ツールの返答には毎回、出典(元のページや GitHub のファイルの URL)と取得日が付きます。ガイドライン本文は HTML から抜き出して整形したものです。
- デジタル庁のロゴは使っていません。