消费者投诉数据库-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
安装依赖项:
或者使用普通的pip
:
跑步
要从命令行直接启动服务器进行烟雾测试:
服务器仅通过 stdio 运行并等待来自 MCP 感知客户端(例如 Claude Desktop)的请求。
运行测试
使用 Python 的 unittest 发现功能执行单元测试。从存储库根目录运行:
这需要安装pyproject.toml
中列出的依赖项。
Claude桌面配置
claude_desktop_config.json
文件包含一个指向complaints.py
脚本的示例条目。将INSERTPATH
替换为你机器上此存储库的路径,然后将配置导入 Claude Desktop。
参考
- CFPB 消费者投诉数据库 API 文档– 此 MCP 服务器使用的底层 API。
- 模型上下文协议快速入门教程——帮助构建此示例的教程。
执照
该项目已获得MIT 许可。
This server cannot be installed
本地 MCP 服务器,使用户能够通过自然语言查询 CFPB 消费者投诉数据库,通过 CFPB API 检索金融消费者投诉记录。
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -78715TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.Last updated -7184TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that connects to Backlog API, providing functionality to search, retrieve, and update issues through natural language commands.Last updated -531JavaScript
- -security-license-qualityAn MCP server that enables natural language interaction with Apache Iceberg data lakehouses, allowing users to query table metadata, schemas, and properties through Claude, Cursor, or other MCP clients.Last updated -31PythonApache 2.0