Consumer Complaint Database MCP

消費者苦情データベース MCP

このリポジトリには、米国消費者金融保護局（CFPB）の消費者苦情データベースへのクエリを実行するための、ローカル専用のMCPサーバーが含まれています。このサーバーは標準入出力経由で起動するように設計されているため、Claude Desktopなどのツールとの統合に最適です。

ファイル

• complaints.py – CFPB API から苦情記録を取得するための単一のツールsearch_complaints公開するメイン MCP サーバー。
• pyproject.toml – 最小限のプロジェクト メタデータと依存関係の宣言。
• claude_desktop_config.json – Claude Desktop からサーバーを起動するための構成例。

要件

• Python 3.11以上
• 依存関係をインストールするためのuvまたはpip

必要な Python パッケージはpyproject.tomlにリストされており、 httpx 、 mcp[cli] 、 python-dateutilが含まれます。

セットアップ（オプション）

uv run自動的に仮想環境を作成し、依存関係をロックして同期し、スクリプトを実行します。 uv run complaints.pyでサーバーを起動する予定の場合は、事前に必要なパッケージをインストールする必要はありません。

パッケージを事前にインストールしたり、単純なpipを使用したりすることを好むユーザーは、 uvを使用して依存関係をインストールします。

あるいは単純なpipを使う場合:

ランニング

スモーク テストのためにコマンド ラインから直接サーバーを起動するには:

サーバーは stdio 経由でのみ実行され、MCP 対応クライアント (例: Claude Desktop) からの要求を待機します。

テストの実行

Pythonのunittestディスカバリを使ってユニットテストを実行します。リポジトリのルートから次のコマンドを実行します。

これには、 pyproject.tomlにリストされている依存関係がインストールされている必要があります。

クロードデスクトップ構成

claude_desktop_config.jsonファイルには、 complaints.pyスクリプトを指すサンプルエントリが含まれています。INSERTPATH INSERTPATHお使いのマシン上のこのリポジトリへのパスに置き換え、設定を Claude Desktop にインポートしてください。

参考文献

• CFPB 消費者苦情データベース API ドキュメント– この MCP サーバーで使用される基礎となる API。
• モデル コンテキスト プロトコル クイックスタート チュートリアル– この例の構築に役立ったチュートリアル。

ライセンス

このプロジェクトはMIT ライセンスに基づいてライセンスされています。