消费者投诉数据库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许可证.