BirdStats MCP插件

mcp服务器鸟类统计

MCP服务器，为代码执行和聊天客户端公开BirdWeather和eBird分析上下文。

此服务器提供什么

此服务器侧重于三个只读工具和一个分析提示：

• get_system_prompt
• get_birdweather_api
• get_ebird_api
• check-bird 提示

这些工具针对低令牌默认值进行了有意优化：

• 默认 mode 是 summary.
• 完全有效载荷访问需要 mode="full" 和 confirmLargePayload=true.
• 工具故障返回结构化错误(status, retryable, suggestion, message)帮助客户自我纠正。

需求

• Node.js 18+
• npm

安装

npm install
npm run build

跑

stdio（默认）

npm run start

或者明确地：

npm run start:stdio

流式HTTP

MCP_TRANSPORT=streamable-http \
MCP_HTTP_HOST=127.0.0.1 \
MCP_HTTP_PORT=3000 \
MCP_HTTP_PATH=/mcp \
npm run start

可选硬化：

• MCP_ALLOWED_ORIGINS=http://localhost,http://127.0.0.1:3000

如果A Origin 标头存在且不允许，服务器返回 403.

码头工人

构建：

docker build -t mcp-server-birdstats .

在stdio模式下运行：

docker run --rm -it mcp-server-birdstats

在流式HTTP模式下运行：

docker run --rm -p 3000:3000 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_HTTP_HOST=0.0.0.0 \
  -e MCP_HTTP_PORT=3000 \
  -e MCP_HTTP_PATH=/mcp \
  mcp-server-birdstats

测试

npm test

行为套件包括：

• 初始化生命周期
• 工具/列表
• 成功的工具/调用
• 使用结构化错误断言的失败工具/调用
• stdio和流式http传输

提供商API说明

包括 birdweather_api.json 和 ebird_api.json 文件是上述工具使用的本地OpenAPI快照。

• BirdWeather参考：https://app.birdweather.com/api/v1/docs
• eBird参考中心：https://support.ebird.org/en/support/solutions/articles/48000838205-ebird-api-1-1

许可证

麻省理工学院

附录：MCP实践（代码执行、工具规模和安全）

最后更新时间：2026-03-23

为何存在此附录

模型上下文协议（MCP）仍然是工具和代理最有用的互操作层之一。权衡的是，大型MCP服务器可能会暴露许多工具，而简单的工具调用可能会用模式、工具聊天和无关的调用痕迹淹没上下文窗口。

在实践中，“更多的工具”并不总是“更好的结果”。工具表面积必须与执行模式相匹配，以保持令牌使用的限制和行为的可预测性。

转换到代码执行/代码模式

最近的工作流程越来越多地将复杂的编排从聊天环境转移到代码执行循环中。这减少了重复的模式标记，使工具使用可审计和可测试。

核心阅读：

• Cloudflare：代码模式
• Cloudflare：使用MCP执行代码
• Anthropic：使用MCP执行代码

高级用户的推荐设置

对于希望使用可重复和低噪声MCP的用户，请从面向代码模式的设置开始：

• 码模式mcp（jx码）
• 东京大学哲学中心

实际警告：即使有强大的设置，模型行为在提供者和版本之间仍然可能不一致。保持重试、护栏和确定性回退到位。

Peter Steinberger风格包装工作流程

一种高杠杆模式是将MCP服务器封装到可调用的代码接口和以任务为中心的CLI中，而不是始终将每个原始工具暴露给模型。

参考工具：

• MCPorter
• 龙虾

什么最适合哪些MCP客户端

• 克劳德代码/代码/光标：适用于直接MCP工作流程，但仍受益于狭窄的工具表面。
• 代码执行包装器（TypeScript/Python CLI）：当工具数量较多或任务链包含多个步骤时更好。
• MCP控制较弱的托管聊天客户端：通过预包装的CLI或网关工具通常更安全。

这个生态系统变化很快。如果您现在正在阅读此内容，则此指南的部分内容可能已经过时。

快速注射：风险、影响和缓解措施

对于使用工具的代理来说，快速注入仍然是一个悬而未决的安全问题。这是可以管理的，但还没有解决。

主要风险：

• 隐藏在工具输出或远程内容中的恶意指令。
• 秘密渗透和未经授权的外部通话。
• 不安全的状态更改（破坏性文件/系统/API操作）。

后果：

• 数据泄露、账户泄露、财务损失和完整性故障。

缓解基线：

• 凭据和工具范围的最低权限。
• 列出目的地并实施出口控制。
• 严格的输入验证和模式执行。
• 人为确认破坏性/高风险行为。
• 具有资源/时间限制的沙盒执行。
• 结构化日志记录、审计跟踪和可回放运行。
• 模型重新摄取前的输出过滤/编辑。

除非明确验证，否则将每个工具输出视为不受信任的输入。