内容
# 大气孢子模型上下文协议服务器
[模型上下文协议服务器](https://modelcontextprotocol.io) 为 [大气孢子](https://atmospore.com).
让克劳德（和其他支持MCP的AI助手）回答全球任何地点关于花粉预报的问题。
## 功能
为克劳德添加了四个工具：
| 工具 | 用途 |
|---|---|
| `get_pollen(纬度, 经度, 预报天数)` | "这周奥斯陆的花粉预报如何？" |
| `get_top_species(纬度, 经度, 限制)` | "现在卑尔根的花粉水平最高是什么？" |
| `get_area_average(纬度, 经度, 半径公里, 预报天数)` | "这周伦敦树木还是草地花粉更严重？" |
| `list_supported_species()` | "你们覆盖了哪些物种？" |
和一个资源：
- `atmospore://help` — 使用说明，可从克劳德桌面版浏览
坐标可在全球任何地点使用 — 模型覆盖全球，精度约为28公里。
## 安装
```bash
pip install atmospore-mcp
```
## 在克劳德桌面版中设置
1. 在 [atmospore.com/account](https://atmospore.com/account) 获取免费的大气孢子API密钥（每天100次调用，无需信用卡）。
2. 编辑克劳德桌面版配置：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%/Claude/claude_desktop_config.json`
3. 添加大气孢子作为MCP服务器：
```json
{
"mcpServers": {
"atmospore": {
"command": "atmospore-mcp",
"env": {
"ATMOSPORE_API_KEY": "ak_your_key_here"
}
}
}
}
```
4. 重启克劳德桌面版。
5. 问克劳德：“今天奥斯陆的花粉水平如何？” — 它将调用工具并回复。
## 示例提示
- "这周奥斯陆的花粉预报如何？"
- "现在斯德哥尔摩树木还是草地花粉更严重？"
- "我对桦树过敏 — 卑尔根的桦树花粉什么时候达到峰值？"
- "比较今天伦敦和哥本哈根的花粉水平。"
## 配额
每次工具调用都会命中大气孢子API，并扣除您的密钥每日配额。免费层级（每天100次调用）涵盖日常使用 — 典型的克劳德对话会触发1-5次工具调用。
重度用户（每天约5次或以上花粉对话）将需要 [付费计划](https://atmospore.com/plans)。
当您达到配额时，工具将返回结构化的 `quota_exceeded` 响应，克劳德将用 plain 语言告诉您： *"您已达到大气孢子每日限制。在 [atmospore.com/plans](https://atmospore.com/plans) 升级。"*
## 本地开发
```bash
git clone https://github.com/atmospore/atmospore-mcp
cd atmospore-mcp
pip install -e ".[test]"
pytest
ATMOSPORE_API_KEY=ak_... atmospore-mcp # 在标准输入/输出上运行服务器
```
## 相关
- [atmospore](https://github.com/atmospore/atmospore-python) — 此服务器封装的底层Python客户端。
- [atmospore.com](https://atmospore.com) — 主机预报和开发者仪表盘。
## 许可证
MIT.
