mcpField
L
ListRiver

ListRiver

本地服务
listriver.com商业与营销05 天前更新
代码仓库访问官网

关于 ListRiver

ListRiver MCP 服务连接美国各州官方企业登记数据，供 AI 助手按地点、行业和企业类型查询新成立及存续企业。可先免费统计匹配数量，再检索企业记录。

主要功能

  1. 01查询新成立及存续企业
  2. 02按州、城市、县和 ZIP 筛选
  3. 03按 NAICS、类型和成立月份筛选
  4. 04查看电话或邮箱是否登记
  5. 05统计匹配数量并分页检索

适用场景

  1. 01查找指定地区的新建筑公司
  2. 02统计近期成立且有电话的企业
  3. 03筛选特定 ZIP 的新 LLC 并查看注册代理人

MCP 相关

提供 list_states、count_businesses 和 search_businesses 工具，供 MCP 客户端查询 ListRiver 企业记录。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "listriver-llc-listriver": {
      "command": "uvx",
      "args": [
        "listriver-mcp"
      ],
      "env": {
        "LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
      }
    }
  }
}
启动命令uvx listriver-mcp
需要配置的环境变量
LISTRIVER_API_KEY密钥Your ListRiver API key (free, 500 records a month: https://listriver.com/Account/ApiSignUp.aspx)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypilistriver-mcp0.1.0

工具

3

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

ListRiver MCP 服务

让 Claude 和其他 AI 助手通过 ListRiver 搜索美国各州官方企业注册机构中的新成立和活跃企业：按州、城市、县、ZIP、NAICS 行业、实体类型、成立月份，以及是否登记了电话或电子邮件，查找新成立的 LLC、公司和非营利组织。

你可以提出这样的问题：

  • “过去 3 个月，Miami-Dade 有多少家成立的企业登记了电话号码？”
  • “查找 Texas 州 Harris County 的 20 家新成立建筑公司。”
  • “列出本月在 ZIP 80202 成立的新 LLC，并附上其注册代理人。”

工具

工具功能费用
list_states覆盖的州及其记录数量免费
count_businesses每个州符合搜索条件的企业数量免费
search_businesses符合条件的企业（默认 25 家，每次最多 100 家；使用 cursor 获取更多结果）返回的每家企业都会计入你的 ListRiver 记录额度

系统会提示助手先统计数量，并且只请求你需要的企业数量。

设置

  1. 获取免费的 API 密钥（每月 500 条记录）：listriver.com/Account/ApiSignUp.aspx
  2. 安装 uv（它会通过 uvx 运行服务，无需安装其他内容）。
  3. 将服务添加到你的 AI 应用中。

Claude Desktop（进入 Settings > Developer > Edit Config，然后重启 Claude Desktop）：

{
  "mcpServers": {
    "listriver": {
      "command": "uvx",
      "args": ["listriver-mcp"],
      "env": { "LISTRIVER_API_KEY": "lr_key_..." }
    }
  }
}

Claude Code：

claude mcp add listriver -e LISTRIVER_API_KEY=lr_key_... -- uvx listriver-mcp

**其他 MCP 客户端：**在环境中设置 LISTRIVER_API_KEY 后，运行 uvx listriver-mcp（stdio）。或者运行 pip install listriver-mcp，然后运行 listriver-mcp。

源码

此文件夹中的服务为 listriver_mcp/server.py（使用 Python 编写，基于官方 MCP Python SDK，并使用此仓库中的 listriver 客户端）。测试文件：tests/test_server.py。

从仓库克隆目录运行：

pip install ./python ./mcp
LISTRIVER_API_KEY=lr_key_... listriver-mcp

或者在仓库根目录构建 Dockerfile：运行 docker build -t listriver-mcp .，然后运行 docker run -i --rm -e LISTRIVER_API_KEY=lr_key_... listriver-mcp。

注意事项

  • 每次返回企业时，都会计入你的记录额度；重复或重叠的搜索会再次计数。统计数量不收费。
  • 仅部分记录包含电话、电子邮件、NAICS 和县信息，且覆盖范围因州而异。
  • 数据仅供你自己开展业务使用，不得转售，也不得用于信贷、保险、就业或住房决策 （ListRiver API 协议）。
  • 更多信息：API 文档 - [email protected]

MIT 许可证。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。