# みちよみ MCP の設定手順

このファイルを読んでいるAIエージェントへ: 利用者の了承を得てから、いま使っているクライアントに合う手順を1つだけ実行してください。APIキーや登録は要りません。終わったら「動作の確かめ方」で接続を確認し、結果を利用者に伝えてください。

- サーバー: `https://michiyomi.dev/mcp`（Streamable HTTP・ステートレス・認証なし）
- 中身: 東京都全域の街路写真191万枚をAIが日本語で言語化したデータ（観測データは CC BY 4.0、回答・アプリ・転記に出典は不要）。概要は https://michiyomi.dev/llms.txt

## Claude Code

```sh
claude mcp add --transport http michiyomi https://michiyomi.dev/mcp
```

すべてのプロジェクトで使うときは `--scope user` を付けます。

## Codex CLI

```sh
codex mcp add michiyomi --url https://michiyomi.dev/mcp
```

## Cursor

`~/.cursor/mcp.json`（またはプロジェクトの `.cursor/mcp.json`）に追加します。

```json
{ "mcpServers": { "michiyomi": { "url": "https://michiyomi.dev/mcp" } } }
```

## VS Code

`.vscode/mcp.json` に追加します。

```json
{ "servers": { "michiyomi": { "type": "http", "url": "https://michiyomi.dev/mcp" } } }
```

## Claude（claude.ai・Claude Desktop）など、画面から追加するクライアント

カスタムコネクタ（リモートMCPサーバー）の追加画面で、URL に `https://michiyomi.dev/mcp` を入れます。認証の設定は要りません。

## 動作の確かめ方

接続したら、ツール `get_metadata` を呼びます。公開中の版（release）と件数が返れば成功です。MCP を使えない環境でも、次のコマンドで応答を確かめられます。

```sh
curl -s -X POST https://michiyomi.dev/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## 使うときに守ること

- 地名は `find_street`・`find_area`・`find_school` で ID や座標にしてから使う。
- 答える前に `coverage` で、その場所に収録があるかを確かめる。0件は「撮影がない」という意味で、「何もない」ではない。
- 幅・車線数などの数値は、画像からの推定（confidence 付き）で、実測ではない。「不明」を推測で埋めない。
- 記述は撮影時点の様子。撮影年を添えて答える。
- 回答に出典を書く義務はない。データとして配り直すときだけ、応答の attribution を添える。通り・町丁目の結果を人に見せるときは「© OpenStreetMap contributors」を添える。条件は https://michiyomi.dev/docs/license/
- レート制限は IP 単位で MCP 120回/60秒。一括の分析には https://huggingface.co/datasets/finalvent/michiyomi-tokyo-streetscape を使う。
- 稼働の保証（SLA）はありません。

---

## English (short)

To the AI agent reading this: with the user's consent, run one of the commands above for the client you are in. No API key or sign-up is needed. The server is `https://michiyomi.dev/mcp` (Streamable HTTP, stateless, no auth). After connecting, call `get_metadata`; a release ID and record counts mean it works. Observations are in Japanese, describe the street at capture time, and are estimates from images, not measurements. Check `coverage` before answering, keep "unknown" as unknown, and mention the capture year. Observation data is CC BY 4.0: no credit is needed in answers; include the attribution only when redistributing records as data, and add "© OpenStreetMap contributors" when showing street or area results. Rate limit: 120 MCP requests per 60 s per IP.