Information
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 许可证获得许可。