消费者投诉数据库-MCP

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

文件

• complaints.py – 主 MCP 服务器，公开单一工具search_complaints ，用于从 CFPB API 检索投诉记录。

• pyproject.toml – 最小项目元数据和依赖声明。

• claude_desktop_config.json – 从 Claude Desktop 启动服务器的示例配置。

Related MCP server: USA Spending MCP Server

要求

• Python 3.11+

• uv或pip用于安装依赖项

所需的 Python 包列在pyproject.toml中，包括httpx 、 mcp[cli]和python-dateutil 。

设置（可选）

uv run会自动创建虚拟环境，锁定依赖项，同步它们，然后执行脚本。如果您计划使用uv run complaints.py启动服务器，则可以跳过提前安装依赖项的步骤。

对于喜欢预安装软件包或使用普通pip的用户，请使用uv安装依赖项：

uv pip install -r pyproject.toml

或者使用普通的pip ：

pip install -r pyproject.toml

跑步

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

uv run complaints.py

服务器仅通过 stdio 运行并等待来自 MCP 感知客户端（例如 Claude Desktop）的请求。

运行测试

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

python -m unittest discover -s tests -v

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

Claude桌面配置

claude_desktop_config.json文件包含一个指向complaints.py脚本的示例条目。将INSERTPATH替换为你机器上此存储库的路径，然后将配置导入 Claude Desktop。

参考

• CFPB 消费者投诉数据库 API 文档– 此 MCP 服务器使用的底层 API。

• 模型上下文协议快速入门教程——帮助构建此示例的教程。

执照

该项目已获得MIT 许可。