Baseline MCP Server

1<p align="center">
2	<img src="./logo.png" alt="Baseline MCP Serverロゴ" width="200" height="200">
3</p>
4 
5<h1 align="center">Baseline MCP Server</h1>
6 
7[日本語版](./README.md) | [English Version](./README_EN.md)
8 
9Web Platform APIのサポート状況を提供するModel Context Protocolサーバーです。
10 
11[![JSR Version](https://jsr.io/badges/@yamanoku/baseline-mcp-server)](https://jsr.io/@yamanoku/baseline-mcp-server)
12 
13## 概要
14 
15このサーバーは、[Web Platform Dashboard](https://webstatus.dev/)のAPIを使用して、WebのAPI機能のBaselineステータス（サポート状況）を取得できるMCPサーバーを実装しています。クエリに基づいてWeb機能の情報を取得し、その結果をMCPクライアントに返します。
16 
17![Claude Desktop上でdetails要素にまつわるBaseline情報を質問してMCPサーバーを経由してその結果が反映されている。内容は<details>要素、相互排他的な<details>要素、::details-content疑似要素のそれぞれをリストアップしてBaselineの情報を伝えている。](./screenshot_claude_desktop.png)
18 
19## 機能
20 
21- Web Platform DashboardのAPIを使用した機能検索
22- 機能のBaselineステータス（`widely`、`newly`、`limited`、`no_data`）の提供
23- ブラウザ実装状況（バージョンと実装日）の提供
24- 機能の使用状況データの提供
25- 特定のブラウザを除外した機能検索（`chrome`, `edge`, `firefox`, `safari`）
26- MCPを介した各種AIモデルとの連携
27 
28## Baselineステータスについて
29 
30Baselineステータスは、Web機能のブラウザサポート状況を示します：
31 
32- **widely**:
33  広くサポートされているWeb標準機能。ほとんどのブラウザで安全に使用できます。
34- **newly**:
35  新しく標準化されたWeb機能。主要なブラウザでサポートされ始めていますが、まだ普及途上です。
36- **limited**:
37  限定的にサポートされているWeb機能。一部のブラウザでは使用できないか、フラグが必要な場合があります。
38- **no_data**:
39  現時点ではBaselineに含まれていないWeb機能。ブラウザのサポート状況を個別に確認する必要があります。
40 
41Baselineについての詳細については「[Baseline (互換性) - MDN Web Docs 用語集](https://developer.mozilla.org/ja/docs/Glossary/Baseline/Compatibility)」を参照してください。
42 
43## MCPクライアントでの設定
44 
45- サーバーを起動するにあたり、Denoの使用を推奨します
46  - パーミッションとして`api.webstatus.dev`のみのアクセスを許可してください
47- [`@yamanoku/baseline-mcp-server`](https://jsr.io/@yamanoku/baseline-mcp-server)を指定するか、お手元のローカル環境にbaseline-mcp-server.tsを設置して読み取るように設定してください
48 
49### Claude Desktop
50 
51Claude
52DesktopのMCPクライアントで使用するには、以下のように`cline_mcp_settings.json`に設定を追加します。
53 
54```json
55{
56  "mcpServers": {
57    "baseline-mcp-server": {
58      "command": "deno",
59      "args": [
60        "run",
61        "--allow-net=api.webstatus.dev",
62        "jsr:@yamanoku/baseline-mcp-server"
63      ]
64    }
65  }
66}
67```
68 
69### Visual Studio Code
70 
71Visual Studio
72CodeのMCPクライアントで使用するには、以下のように`settings.json`に設定を追加します。
73 
74```json
75{
76  "mcp": {
77    "servers": {
78      "baseline-mcp-server": {
79        "command": "deno",
80        "args": [
81          "run",
82          "--allow-net=api.webstatus.dev",
83          "jsr:@yamanoku/baseline-mcp-server"
84        ]
85      }
86    }
87  }
88}
89```
90 
91## Dockerによる起動
92 
93最初にDockerイメージをビルドします。
94 
95```shell
96docker build -t baseline-mcp-server .
97```
98 
99MCPクライアントの設定でDockerコンテナを実行するようにします。
100 
101```json
102{
103  "mcpServers": {
104    "baseline-mcp-server": {
105      "command": "docker",
106      "args": [
107        "run",
108        "-i",
109        "baseline-mcp-server:latest"
110      ]
111    }
112  }
113}
114```
115 
116## 謝辞
117 
118このOSSはGPT-4o Image Generationによってロゴを製作、Claude 3.7
119Sonnetによって実装、ドキュメントのサンプルを提案いただきました。感謝申し上げます。
120 
121## ライセンス
122 
123[MIT License](./LICENSE)
124