MCP Registry は、Model Context Protocol (MCP) サーバーのディレクトリであり、IDE や Copilot のカタログとして機能します。
Enterprise または Organization 所有者は、MCP Registry URL とアクセス制御ポリシーを構成して、開発者が使用できる MCP サーバーを管理できます。
MCP Registry の JSON フォーマット MCP Registry は、公式スキーマに準拠した以下の構造の JSON 応答を返す必要があります。
参照: https://registry.modelcontextprotocol.io/docs#/operations/list-servers-v0.1
{
"metadata" : {
"count" : 2 , // 登録したサーバーの総数
"nextCursor" : " server-name:version" // ページネーション用カーソル（オプション）
},
"servers" : [
{
"server" : {
"$schema" : " https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json" "name" : " example.com/server-name" // 名前空間付きのサーバー名（例: "ai.example/my-server"）
"version" : " 1.0.0" // セマンティックバージョニング形式
"description" : " サーバーの説明" "repository" : {
"url" : " https://github.com/org/repo" "source" : " github" "subfolder" : " path/to/server" // オプション: サブフォルダパス
},
// 以下のいずれかの配置方法を指定:
// 1. packages配列: PyPI, npm, OCI等のパッケージレジストリから配布
"packages" : [
{
"registryType" : " npm" // "npm", "pypi", "oci" など
"registryBaseUrl" : " https://registry.npmjs.org" "identifier" : " package-name" "version" : " 1.0.0" "runtimeHint" : " npx" // オプション: 実行時のヒント
"transport" : {
"type" : " stdio" // "stdio" または "sse"
},
"environmentVariables" : [
{
"name" : " API_KEY" "description" : " APIキーの説明" "isRequired" : true ,
"isSecret" : true ,
"default" : " default-value" // オプション
"format" : " string" // オプション
}
]
}
],
// 2. remotes配列: リモートMCPサーバーとして配布
"remotes" : [
{
"type" : " sse" // "sse" または "streamable-http"
"url" : " https://example.com/mcp" "headers" : [
// オプション: 追加HTTPヘッダー
{
"name" : " Authorization" "description" : " 認証トークン" "value" : " Bearer ${TOKEN}" // 環境変数参照可能
"isSecret" : true
}
]
}
]
},
"_meta" : {
"io.modelcontextprotocol.registry/official" : {
"status" : " active" // "active" または "deprecated"
"publishedAt" : " 2025-01-01T00:00:00.000000Z" // ISO 8601形式（マイクロ秒まで）
"updatedAt" : " 2025-01-01T00:00:00.000000Z" // ISO 8601形式（マイクロ秒まで）
"isLatest" : true // 最新バージョンの場合はtrue
}
}
}
]
}
metadataservers
server
$schemahttps://static.modelcontextprotocol.io/schemas/YYYY-MM-DD/server.schema.json）name"ai.example/my-server"）version"1.0.0"）descriptionrepository
urlsource"github"）
配置方法（以下のいずれか必須） :
packagesremotes
_meta
io.modelcontextprotocol.registry/official
status"active" または "deprecated"）publishedAtupdatedAtisLatest
metadata.nextCursorserver.repository.subfolderpackages[].runtimeHint"npx", "uvx"）packages[].environmentVariablesremotes[].headers
packages を使用する場合
registryType: "npm", "pypi", "oci" などtransport.type: "stdio" または "sse"
remotes を使用する場合
type: "sse" または "streamable-http"OAuth 認証等が必要な場合は headers でトークンを指定可能
以下は、公式 MCP Registry API (list-servers-v0.1) のプロパティ定義です。
参照元: https://registry.modelcontextprotocol.io/docs#/operations/list-servers-v0.1
metadata (object, required)ページネーションメタデータ
countnextCursorcursorクエリパラメータにこの値を使用する
servers (array[object] or null, required)サーバーエントリのリスト
各サーバーエントリは以下の構造を持つ:
server (object, required)サーバー設定とメタデータ
$schema
制約: 1 文字以上
例: "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json"
name
制約: 3-200 文字
パターン: ^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$
例: "io.github.user/weather"
version
description
制約: 1-100 文字
例: "MCP server providing weather data and forecasts via OpenWeatherMap API"
title
制約: 1-100 文字
例: "Weather API"
websiteUrl
例: "https://modelcontextprotocol.io/examples"
icon
推奨: GitHub organization のアバター画像 URL（例: "https://avatars.githubusercontent.com/u/124619424?s=200&v=4"）
形式: PNG, SVG などの画像形式
例: "https://avatars.githubusercontent.com/u/124619424?s=200&v=4"
repository
url
例: "https://github.com/modelcontextprotocol/servers"
sourcesubfolderid
例: "b94b5f7e-c7c6-d760-2c78-a5e9b8a5b8c9"
icons
各アイコンオブジェクト:
src
例: "https://example.com/icon.png"
mimeTypesizestheme"light", "dark", etc.)
packages
registryType
値: "npm", "pypi", "oci" など
例: "npm"
registryBaseUrl
例: "https://registry.npmjs.org"
identifier
例: "@modelcontextprotocol/server-brave-search"
versionruntimeHintfileSha256
例: "fe333e598595000ae021bd27117db32ec69af6987f507ba7a63c90638ff633ce"
transport
type"stdio" または "sse")urlheaders
environmentVariablespackageArgumentsruntimeArguments
remotes
type"stdio", "sse", "streamable-http")url
例: "https://api.example.com/mcp"
headers
_meta
レジストリ管理メタデータ
io.modelcontextprotocol.registry/official
status
許可値: "active", "deprecated", "deleted"
publishedAt
形式: ISO 8601 (RFC3339)
例: "2019-08-24T14:15:22Z"
updatedAt
形式: ISO 8601 (RFC3339)
例: "2019-08-24T14:15:22Z"
isLatest
cursor
limit
制約: 1-100
デフォルト: 30
例: 50
search
updated_since
例: "2025-08-07T13:15:04.280Z"
version'latest'、または'1.2.3'のような正確なバージョン)
このリポジトリでは MCP Registry の管理を行っています。
ファイルパス : docs/registry.json公開方法 : GitHub Pages にて自動公開更新方法 : ユーザーから MCP サーバーの追加・更新・削除の指示があった場合は、docs/registry.json を直接編集してください
JSON フォーマットに従って正確に記述する
公式スキーマ（https://static.modelcontextprotocol.io/schemas/YYYY-MM-DD/server.schema.json）に準拠すること
metadata.count を更新する
レジストリ内の全サーバーバージョンの総数に合わせる（最新版のみでなく全バージョンを含む）
サーバー名は名前空間付きで記述する
形式: "組織ドメイン/サーバー名" （例: "ai.example/my-server", "com.github/awesome-server"）
一意性を保つため、ドメインベースの命名規則を推奨
必須フィールドを必ず含める
server.$schema: スキーマ URLserver.name: 名前空間付きサーバー名server.version: セマンティックバージョンserver.description: サーバーの説明server.packages または server.remotes: 配置方法（いずれか必須）_meta.io.modelcontextprotocol.registry/official: 公式メタデータ
日時は ISO 8601 形式（マイクロ秒精度）で記述する
形式: "YYYY-MM-DDTHH:mm:ss.ffffffZ"
例: "2025-11-27T10:30:45.123456Z"
publishedAt: 新規追加時の日付updatedAt: 更新時の日付
リポジトリ情報を可能な限り含める
repository.url: GitHub リポジトリ URLrepository.source: "github" などrepository.subfolder: モノレポの場合はサブフォルダパス
アイコンを設定する（推奨）
server.icon: サーバーのアイコン画像 URL を指定推奨: GitHub organization のアバター画像 URL を使用
形式: "https://avatars.githubusercontent.com/u/{org_id}?s=200&v=4"
Organization ID の確認方法:
GitHub organization ページの URL から取得
または GitHub API を使用: https://api.github.com/orgs/{org_name}
例: Model Context Protocol の場合
"icon": "https://avatars.githubusercontent.com/u/124619424?s=200&v=4"
配置方法（packages または remotes）を適切に選択する
packages : PyPI、npm、OCI 等のパッケージレジストリから配布する場合
registryType, identifier, version, transport を指定環境変数が必要な場合は environmentVariables を定義
remotes : HTTP エンドポイント経由でサービスとして提供する場合
type ("sse" または "streamable-http") と url を指定認証が必要な場合は headers を定義
バージョン管理の注意点
同じサーバーの複数バージョンを登録可能
最新バージョンのみ _meta.io.modelcontextprotocol.registry/official.isLatest を true に設定
古いバージョンは false に設定
docs/mcp-registry.md の更新
docs/registry.json を更新した後、必ず docs/mcp-registry.md のサーバー一覧テーブルも更新するテーブルフォーマット: | 名前 | 説明 |
名前カラムには server.repository.url へのリンクを設定: [server.name](repository.url)
説明カラムには server.description の内容をそのまま記載
最新バージョンのみをテーブルに含める（isLatest: true のもの）
MCP Registry の更新作業が完了した後、追加された MCP サーバーのセキュリティ評価を実施してください。
実行手順 :
.github/prompts/mcp-security-servey.prompt.md に記載された指示に従う追加された MCP サーバー名を入力として使用
セキュリティサーベイを実施し、PR Template を埋めた markdown file を repository root に生成し、保存する
詳細な指示については、.github/prompts/mcp-security-servey.prompt.md を参照してください。
