ballpark

Name: ballpark
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 ballpark

ballpark 是面向 Dribba 工作室数据服务的本地 MCP 桥接工具和 CLI，可转发调用以查询服务、案例、预算估算、公司信息并提交联系请求。

主要功能

01列出工作室服务和案例
02估算项目预算
03返回结构化公司信息
04转发联系请求
05原样传递远程结果

适用场景

01查看 Dribba 的服务与作品
02估算应用或产品预算
03查询公司信息
04发送已确认的项目咨询

MCP 相关

它提供本地 stdio MCP 服务，展示捕获的工具列表，并通过 streamable HTTP 将工具调用转发到 Dribba 的远程 MCP 服务。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-ballpark": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/ballpark"
      ]
    }
  }
}

启动命令npx -y @reneturcios/ballpark

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

安装包

npm@reneturcios/ballpark0.1.0stdio

ocighcr.io/cloudcorprecords/ballpark:0.1.0stdio

工具

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

参数	类型	必填	说明
limit	integer	否	要返回的服务的最大数量。省略时返回全部服务。

详细介绍

ballpark

已发布的 Dribba MCP 远程服务的转发客户端。 Dribba 是一家产品工作室；其远程 MCP 服务公开了工作室数据——其服务、案例研究、预算估算计算器、结构化公司信息，以及联系请求工具。该远程服务没有可安装的软件包，因此 ballpark 为其提供了本地 stdio MCP 服务和一个小型 CLI：tools/list 通过远程服务的逐字实时捕获结果在本地响应，所有 tools/call 则通过可流式传输的 HTTP 转发到远程服务。

上游结果会原样传递，包括 structuredContent 和任何 isError 标记。往返过程中发生的故障会作为错误结果报告，其文本以 ballpark error: 开头。

上游服务与覆盖设置

上游服务：https://dribba.com/mcp（固定）。
覆盖设置：设置 DRIBBA_MCP_URL，将客户端指向其他端点。此覆盖设置是重建版本的功能：仅远程服务的原始版本没有发布覆盖设置。
客户端握手依次为 initialize（协议版本 2025-03-26，客户端 ballpark / 0.1.0）、然后是 notifications/initialized，最后是 tools/call。当上游服务发出 Mcp-Session-Id 时，后续每个请求都会使用该 ID。响应可以是普通 JSON，也可以是 SSE 流。
参数验证在本地进行：未知工具或格式错误的参数会在转发前失败。 submit_contact_request 与其他工具一样会被转发；其捕获的描述原样提供，其中要求调用前明确征得用户确认，确认具体的姓名、邮箱和消息；此重建版本不会自行添加任何门控。

安装与运行

npx -y @reneturcios/ballpark mcp          # stdio MCP server
npx -y @reneturcios/ballpark --version    # 0.1.0
npx -y @reneturcios/ballpark list_services '{"limit":3}'
npx -y @reneturcios/ballpark estimate_project '{"platforms":["ios","web"],"complexity":"standard"}'
npx -y @reneturcios/ballpark list_projects '{"industry":"fintech"}'
npx -y @reneturcios/ballpark company_facts '{"fields":["offices","distinctions"]}'

每个工具子命令接收一个 JSON 字符串参数，并打印转发后的结果。退出代码：成功时为 0，错误结果时为 1，用法或验证错误时为 2。

MCP 客户端配置

{
  "mcpServers": {
    "ballpark": {
      "command": "npx",
      "args": ["-y", "@reneturcios/ballpark", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/ballpark                    # stdio MCP server
docker run --rm ghcr.io/cloudcorprecords/ballpark --version        # CLI

工具

工具	功能
`list_services`	列出 Dribba 的服务，并为每项提供一行摘要和 URL。
`estimate_project`	估算应用／产品的预算及范围，对应 dribba.com 的公开计算器。项目最低预算为 €30,000。需要提供 `platforms`。
`list_projects`	列出 Dribba 的案例研究（slug、标题、行业）。
`company_facts`	关于 Dribba 的结构化信息：定位、办公室、团队、差异化优势、客户。
`submit_contact_request`	代表用户向 Dribba 提交真实的项目咨询。这会发送电子邮件并创建潜在客户——只有在用户明确确认要发送的具体姓名、邮箱和消息后，才能调用此工具。Dribba 会在 1 小时内回复。按客户端限流。

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source