消费者投诉数据库查询服务

消费者投诉数据库MCP

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

文件

• complaints.py –暴露单个工具的主MCP服务器， search_complaints，用于从CFPB API检索投诉记录。
• pyproject.toml –最少的项目元数据和依赖关系声明。
• claude_desktop_config.json –从Claude Desktop启动服务器的示例配置。

需求

• Python 3.11+
• 紫外线 或 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的单元测试发现执行单元测试。从存储库 root，运行：

python -m unittest discover -s tests -v

这需要中列出的依赖关系 pyproject.toml 待安装。

Claude桌面配置

这 claude_desktop_config.json 该文件包含一个指向的示例条目 complaints.py 脚本。替换 INSERTPATH 使用您计算机上此存储库的路径，并将配置导入Claude Desktop。

参考文献

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

许可证

该项目根据 MIT许可证.