MCPサーバー実装・運用ガイド
MCPサーバーを作る前に決める境界、公開パッケージとして配る方法、Claude Codeから使う実例を集めます。
まず読む
e-Gov法令MCPとは？Claude Codeで日本法令を参照する設計と作り方
e-Gov法令APIをClaude CodeやCursorから使うMCPサーバーの仕組み、stdio設定、出典付き条文取得、安全境界、既存実装との差別化を解説します。
関連ツール
-
EDINETの書類種別コード一覧と絞り込み：docTypeCode・formCodeで半期報告書・大量保有報告書を分ける
EDINET API v2の書類一覧を書類種別コード（docTypeCode）で絞る方法を、金融庁の仕様書と様式コードリストで確認して整理。変更報告書は350のまま様式コードで分かれる、半期報告書には043A00がある、大量保有はissuerEdinetCodeで引く、の3点を架空JSONと通信しないNode.jsコードで再現します。
edinet / public-data / nodejs / mcp -
EDINETの保存JSONから有報の取得候補を作る：Node.jsで訂正・取下げ・不開示を分ける
EDINETの書類一覧JSONをローカルで読み、有価証券報告書と訂正報告書のCSV取得候補を整理するNode.jsサンプル。架空10行を候補2・除外5・要確認3に分け、親docID、操作情報、欠損フラグを確認します。API接続や財務値の抽出は行いません。
edinet / public-data / nodejs / mcp -
Claude Code hooksレシピ7本：危険コマンド阻止・.env保護・自動整形・Stopでテスト
Claude Code hooksレシピ7本。PreToolUseでrm -rfや.envを止め、PostToolUseで整形、Stopでテストを差し戻す設定を、Windowsでの実行出力付きで紹介。導入前に決める安全境界も整理。
claude-code / workflow / security / hooks / mcp / agent-ops -
EDINET APIをMCP化する設計：書類検索・取得・XBRL抽出の3ツールとキー管理・出典保持
金融庁EDINET API v2をMCP化する設計案。書類検索→取得→XBRL/CSV抽出の3ツール分割、Subscription-Keyの環境変数管理とマスク、日次一覧と書類本体で分けるキャッシュ、docID・提出日時を保持する出典スキーマを型定義とスケルトンで示します（2026-09-14、キー未取得で実行未検証）。
mcp / ai-agent / legal-tech / edinet / security / workflow -
EDINET API v2の使い方：APIキー取得・書類一覧・書類取得の仕様と有報をAIで読む設計
金融庁EDINET API（Version 2）の書類一覧API・書類取得API・APIキー発行手順・ステータスコード・更新タイミングを、2026年6月版の公式仕様書で確認して整理。キー未取得のため実行は未検証ですが、キーなしで返る401応答は実測しました。有価証券報告書をAIエージェントで読む設計まで。
ai-agent / mcp / legal-tech / edinet -
e-Gov法令API v1からv2への移行ガイド：エンドポイント対応表と労基法での応答比較
e-Gov法令API v1（lawlists・lawdata・articles・updatelawlists）からv2への移行を、エンドポイント対応表とパラメータの読み替えで整理。労働基準法を両方で取得してXMLとJSONの差を比べ、v1提供終了の公式告知の有無も2026年9月14日に確認しました。
egov / japanese-law / legal-tech / mcp -
e-Gov法令API v2エンドポイント逆引きリファレンス：6本の用途・パラメータ・実測レスポンス
e-Gov法令API v2の6エンドポイント（laws / law_revisions / law_data / keyword / law_file / attachment）を、やりたいこと別に逆引きできる形で整理。全エンドポイントをcurlで実行し、主要パラメータと応答を2026年9月14日に実測しました。
egov / japanese-law / legal-tech / api / json / mcp / claude-code -
e-Gov法令API v2のキーワード検索：検索式・ページング・ヒットしない語の実例
e-Gov法令API v2の keyword エンドポイントで条文本文を全文検索する方法を解説。AND・OR・NOT・括弧・ワイルドカードの書き方、total_countが文の数である点、next_offsetによるページング、半角英字がヒットしない実例を2026年9月14日のcurl実測で確認しました。
egov / japanese-law / legal-tech / api / troubleshooting / tips / mcp -
e-Gov法令API v2のlawsで法令一覧を絞り込む：公布日・種別・分類・廃止状態の実例
e-Gov法令API v2の /laws で使える21個のクエリパラメータをOpenAPI定義から一覧化。公布日の範囲・法令種別・事項別分類・廃止状態・改正法令IDでの絞り込みを2026年9月14日にcurlで実行し、件数と応答の読み方、orderの並び方の注意点を確認しました。
egov / japanese-law / legal-tech / api / json / mcp -
e-Gov法令API v2をTypeScriptで使う：依存なしfetchで法令検索からJSON保存まで
e-Gov法令API v2をTypeScript（Node.js標準のfetch、依存パッケージなし）で呼び出し、法令名検索→法令ID確定→本文取得→JSON保存まで動く116行のサンプルを解説。Node.js 24.8・22.14・tsxの3通りで2026年9月14日に実行確認しました。
egov / japanese-law / legal-tech / typescript / api / json / mcp -
Codex CLIでe-Gov法令MCPを使う：codex mcp add と config.toml の設定手順
Codex CLI 0.144.1 に e-Gov法令MCPを codex mcp add で追加し、config.toml の [mcp_servers] 形式と codex exec からのツール呼び出しを2026年9月14日にWindows 11で実行確認。Claude Codeとの違いも整理します。
egov / japanese-law / legal-tech / mcp / codex / codex-cli / npm / stdio / windows -
e-Stat API 3.0の使い方：appId取得と統計表・メタ情報・統計データの取得手順
政府統計e-Stat API 3.0のappId取得手順、getStatsList・getMetaInfo・getStatsDataのURLとパラメータ、レスポンス構造、10万件上限とNEXT_KEYを公式仕様（2026-09-14確認）で整理。AIエージェントに統計を引かせる時の表ID・単位・注記の扱いも。
ai-agent / mcp / estat / public-data / open-data -
国土地理院の住所検索APIと逆ジオコーダーの使い方：表記ゆれと複数候補を実測
国土地理院の住所検索API（住所→緯度経度）と逆ジオコーダー（緯度経度→住所）を2026年9月14日に実測。応答の構造、漢数字・全角・旧地名での結果の違い、複数候補の扱い、muniCdの読み方、公式な位置づけと利用規約、AIエージェントで住所を検証する設計まで。
ai-agent / mcp / public-data -
法人番号システムWeb-APIの使い方：アプリケーションID申請から名称検索・差分取得まで
国税庁の法人番号システムWeb-API（Ver.4.0）について、アプリケーションIDの発行届出、法人番号指定・期間指定・法人名指定の3リクエストとパラメータ、CSV/XMLレスポンス、変更履歴の扱いを公式仕様（2026-09-14確認）で整理。AIエージェントで取引先マスタを照合する時の注意も。
ai-agent / mcp / public-data / open-data / houjin-bangou -
気象庁の天気予報JSON（公式APIではない）の使い方：地域コード・URLの形・利用条件
気象庁の天気予報JSONは、forecast/130000.json（東京都の例）のようなURLを、キーなしのGETで取得できます。地域コードの調べ方、timeSeriesの読み方、公式APIではない点と利用条件を、2026年9月14日のNode.js実測で確認しました。AIエージェント・MCPから使う設計まで扱います。
ai-agent / mcp / public-data -
国会会議録APIをMCPサーバー化する：TypeScript最小実装とClaude Code登録まで
国会会議録検索APIをMCP TypeScript SDK v2(@modelcontextprotocol/server 2.0.0)でstdioサーバーにする手順。検索・発言取得の2ツール、出典を返すoutputSchema、JSON-RPCを直接流した動作確認ログ、claude mcp addの構文まで(2026-09-14実測)。
mcp / diet / ai-agent / claude-code / stdio / json -
国会会議録検索APIの使い方：発言検索・会議録取得・ページングをcurlで実測（キー不要）
国立国会図書館の国会会議録検索システムAPIを2026年9月14日に実測。speech・meeting・meeting_listの3エンドポイント、主要パラメータ、JSONの項目、ページング、全角半角の扱い、無効な院名が黙って無視される癖まで、実際の出力を根拠に解説します。
diet / ai-agent / mcp / japanese-law -
国立国会図書館サーチAPIの使い方：OpenSearch・SRUの検索例とAIエージェント設計
NDLサーチのOpenSearch・SRU・OAI-PMHのエンドポイントと主要パラメータ、利用申請が要る条件、クレジット表示、アクセス制限を公式資料で確認し、書名・著者・ISBN検索を2026年9月14日に実行。AIエージェントで文献調査するときの出典保持も整理しました。
ai-agent / mcp / public-data -
公共データAPIをMCP化する設計パターン：認証キー・識別子・出典・レート制限の共通解
e-Gov法令・国会会議録・EDINET・e-Stat・法人番号の公共APIをMCPにする共通設計。認証キーの環境変数化、識別子の正規化、出典と時点の保持、レート制限とキャッシュ、見つからない時に止まる設計、stdio/HTTPの選択をegov-law-mcpの実装（2026-09-14確認）で例示。
mcp / ai-agent / public-data / egov / workflow / security -
e-Gov法令API v2をPythonで使う：法令検索・本文保存とBase64復号
e-Gov法令API v2をPythonの標準ライブラリで呼び出す実践ガイド。法令名からIDを探し、asofで時点を指定してJSON・XMLを保存します。Base64の復号、2時点比較、MCP向け1条のJSON化まで、実行確認済みのダウンロード用コード付きで解説します。
egov / python / api / xml / json / mcp -
e-Gov法令XMLをMCP用JSONへ：1条の抽出をPythonで再現する
e-Gov法令XMLから本則または指定した附則の1条をJSONへ変換。Python標準ライブラリの配布コードと架空fixtureで、条・項・号、ルビ、出典・履歴IDを保持する処理を再現できます。
mcp / egov / python / japanese-law / xml / json / legal-tech -
houan-mcpとe-Gov法令MCPの調査フロー｜法案から現行法まで
国会提出法案をhouan-mcpで特定し、成立・公布を確認してからe-Gov法令検索へつなぐ実務フローです。法案名と法律名を混同せず、現行条文・過去時点・一次URLを証拠として残す方法を解説します。
mcp / egov / legal-tech / houan-mcp / source-attribution / research-workflow -
日本の公共データAPI 5選：MCPで使うe-Gov・国会・統計・法人情報の選び方
日本の公共データをMCPから使う開発者向けに、e-Gov・国会会議録・e-Stat・Gビズインフォ・EDINETを比較。用途・認証・識別子からAPIを選び、法令の時点指定やXML変換の実装例へ進めます。
mcp / public-data / egov / estat / edinet / gbizinfo / diet / open-data -
法令をAIで扱うときの安全境界：出典・施行日・改正履歴の確認チェックリスト
法令調査をAIやMCPで補助するとき、何を自動化し、どこで人が確認するかを整理。法令ID、公布日、施行日、基準日、改正履歴、引用位置を残す実務チェックリストです。
ai-agent / mcp / egov / japanese-law / legal-tech / source-check / governance -
LM Studioの使い方：導入・モデル選び・API連携
LM Studioの導入から、ローカルLLMの選び方、日本語チャット、PDF・文書RAG、OpenAI互換API、CLI、MCP、重い・動かないときの対処までを初心者向けに詳しく解説します。
lm-studio / local-llm / gguf / rag / openai-compatible-api / mcp / windows / ai-tools -
MCPサーバーをJSON-RPCでテストする｜stdio最小ハーネス
MCP 2026-07-28のstdioサーバーをLLMクライアントなしで検査するNode.js最小ハーネスです。server/discover、必須_meta、tools/list、改行区切り、stdout汚染を切り分けます。
mcp / json-rpc / stdio / testing / nodejs / troubleshooting -
MCPの出典情報を欠落させない｜provenance用outputSchema設計
MCPツールの回答へ出典URL、発行者、取得日時、該当箇所、ハッシュを構造化して残すoutputSchema設計です。2026-07-28仕様のstructuredContentとJSON Schema 2020-12に沿う実装例を示します。
mcp / source-attribution / structured-content / json-schema / legal-tech / agent-ops -
MCPのstdioとStreamable HTTPはどう選ぶ？2026年版の判断基準
MCP 2026-07-28仕様を基準に、stdioとStreamable HTTPの違い、互換性、安全性、運用コストを判断表と導入手順で整理します。
mcp / stdio / streamable-http / ai-agent / architecture -
Cloudflare WorkersでRemote MCPを安全に運用する設計ガイド
Cloudflare Workers上のRemote MCPを、現行createMcpHandler、OAuth、権限、レート制限、監査ログ、停止条件まで含めて段階的に設計します。
mcp / cloudflare-workers / oauth / security / observability -
e-Gov法令API v2のasof：2時点の条文を比較して保存する
e-Gov法令API v2のasofを使い、同じ法令IDの2025年6月と2026年1月の版を比較。Pythonの実行コード、履歴ID・XML差分・出典の保存、失敗時の確認手順を2026年9月26日の実測で解説します。
mcp / egov / python / japanese-law / legal-tech / troubleshooting -
「下請法」で法令検索すると0件になる｜通称と現行法令名のズレをMCPで埋める
e-Gov法令MCP(@codeagentjp/egov-law-mcp)のsearch_lawsは法令名マッチのため、下請法・電帳法・景表法といった通称は0件で返ります。実測ログをもとに、通称→正式名称の解決手順と、改題された法令の扱いを整理します。
mcp / claude-code / cursor / egov / japanese-law / troubleshooting -
egov-law-mcpが動かない時の対処法｜npx・Node.js・Windows接続エラー
e-Gov法令MCP(@codeagentjp/egov-law-mcp)がClaude CodeやCursorで接続失敗する時の切り分け手順を、npx解決、Node.jsバージョン、Windows固有、e-Gov API側の4段階で解説します。
mcp / claude-code / cursor / egov / japanese-law / npm / troubleshooting -
国会の情報を AI エージェントから引く——houan-mcp の7つの実用ユースケース
Claude Desktop / Claude Code / Cursor から国会会議録と議案情報を出典付きで引ける @codeagentjp/houan-mcp の使いどころを、記者・法務・研究者・市民目線で7つのユースケースに整理します。答弁検索、法案ウォッチ、大臣発言の時系列追跡まで。
mcp / houan / japanese-diet / ndl-kokkai / legal-tech / policy-tech / claude-code / ai-agent -
サブエージェント・スキル・MCP・hooks・コマンドの使い分け早見表
Claude Code のサブエージェント、スキル、MCP、hooks、コマンドは「コンテキストを汚さず・確実に・拡張する」の3目的で役割が分かれます。早見表で一発整理します。
claude-code / subagents / skills / mcp / hooks / workflow -
MCP入門 — 仕組み・繋ぎ方・最初に入れるサーバーを実例で理解する
MCPはAIに外部ツールやデータを差し込む共通規格です。仕組み、用語、claude mcp addでの繋ぎ方、最初に入れると効くサーバーの型まで初学者向けに整理します。
mcp / claude-code / getting-started / foundations / tools -
MCPサーバーが繋がらない時のチェックリスト — claude mcp add・stdio・HTTP・環境変数
MCPサーバーが繋がらない原因の多くはコマンドパス・作業ディレクトリ・環境変数・トランスポート種別の取り違えです。stdioとHTTPの違いから切り分け手順までまとめます。
mcp / claude-code / troubleshooting / stdio / tips -
Claude Codeでe-Gov法令を検索する｜egov-law-mcpの設定と使い方
e-Gov法令MCPをClaude Code、Claude Desktop、Cursorへ追加し、法令検索・条文取得・関連法令確認を出典URL付きで行う手順を解説します。
mcp / claude-code / cursor / egov / japanese-law / legal-tech / npm -
e-Gov法令MCPをnpm公開する方法｜パッケージ配布・CI・provenance
e-Gov法令MCPをスコープ付きnpmパッケージとして公開し、GitHub Actions、Granular Access Token、provenance publishを設定する手順を解説します。
mcp / npm / github-actions / release / egov / japanese-law / provenance -
源内OSSのLawsy実装をMCP化するなら、どこを残してどこを捨てるか
デジタル庁が2026年4月に公開した源内OSSの範囲とライセンスを押さえたうえで、Lawsy-Custom-BQを低コストな日本法令MCPへ再構成する設計境界、MVP機能、データ更新、リスクを整理します。
gennai / lawsy / mcp / egov / rag / legal-tech / government-ai / oss -
houan-mcpで関連法案を検索する: 議事録公開前の調査フロー
議事録公開前に、衆参の公式議案情報から関連法案を探す方法を @codeagentjp/houan-mcp の実演として整理します。
mcp / claude-code / diet / japanese-law / legal-tech / npm -
e-Gov法令MCPとは？Claude Codeで日本法令を参照する設計と作り方
e-Gov法令APIをClaude CodeやCursorから使うMCPサーバーの仕組み、stdio設定、出典付き条文取得、安全境界、既存実装との差別化を解説します。
mcp / egov / japanese-law / legal-tech / claude-code / source-attribution