Consumer-Complaint-Database-MCP

此仓库包含一个仅限本地使用的 MCP 服务器，用于查询美国消费者金融保护局 (CFPB) 的消费者投诉数据库。该服务器设计为通过标准输入/输出启动，非常适合与 Claude Desktop 等工具集成。

文件

• complaints.py – 主 MCP 服务器，提供了一个名为 search_complaints 的工具，用于从 CFPB API 检索投诉记录。
• 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 安装依赖项：

bash
uv pip install -r pyproject.toml

或者使用纯 pip：

bash
pip install -r pyproject.toml

运行

要直接从命令行启动服务器进行冒烟测试：

bash
uv run complaints.py

服务器仅运行于标准输入/输出，并等待来自 MCP 感知客户端（例如 Claude Desktop）的请求。

运行测试

使用 Python 的 unittest 发现功能执行单元测试。从仓库根目录运行：

bash
python -m unittest discover -s tests -v

这需要安装 pyproject.toml 中列出的依赖项。

Claude Desktop 配置

claude_desktop_config.json 文件中包含一个指向 complaints.py 脚本的示例行。将 INSERTPATH 替换为此仓库在您机器上的路径，并将配置导入 Claude Desktop。

参考资料

• CFPB 消费者投诉数据库 API 文档 – 此 MCP 服务器使用的底层 API。
• Model Context Protocol 快速入门教程 – 帮助构建此示例的教程。

许可证

此项目根据 MIT 许可证获得许可。