内容
# Alltag
**Alltag**(德语意为“日常”)是一个MCP服务器,它将您最常查找的信息集中到Claude Desktop和其他MCP客户端的单一界面中。它通过一个服务器提供天气、新闻、汇率、旅行、食谱、参考数据等,使用最适合每项任务的来源。它还具有一个`daily_briefing`工具,可以将多个服务的更新合并到一份报告中。
### 亮点
- **立即生效。** 安装后,超过35个工具可用,无需API密钥。
- **可选升级。** 通过简单的配置向导,为股票、经济数据、营养、航班跟踪和电影添加您自己的API密钥。
- **本地运行。** API密钥保留在您的机器上,直接发送到您选择的服务。
## 快速入门
需要 **Node.js 18 或更新版本**。
将以下内容添加到您的 `claude_desktop_config.json` 中:
```json
"mcpServers": {
"alltag": {
"command": "npx",
"args": ["-y", "alltag-mcp"]
}
}
```
重启Claude Desktop,服务器即可使用。
示例:
> "给我一份里斯本的日常简报。"
### 从本地检查运行
在用以下命令构建项目后:
```bash
npm run build
```
指向Claude Desktop编译后的入口点:
```json
{
"mcpServers": {
"alltag": {
"command": "node",
"args": ["C:/path/to/alltag/dist/cli.js"]
}
}
}
```
## 可用工具
### 每日简报
`daily_briefing` 将多个常用更新合并到一个响应中:
- 当前天气
- 空气质量
- 今日公共假期(如果适用)
- 外汇变动
- 加密货币观察列表
- 主要新闻标题
- 个人股票观察列表(配置后)
如果未提供位置,服务器会根据您的公共IP地址估计您的当前城市。提供位置始终优先。
---
### 1级 - 无需API密钥
| 类别 | 工具 |
| --- | --- |
| 天气与环境 | `weather`, `air_quality`, `earthquakes_near` |
| 货币与加密货币 | `currency_convert`, `fx_rate`, `crypto_price` |
| 新闻与参考 | `rss`, `hacker_news`, `wiki_summary` |
| 一般参考 | `define`, `country_facts`, `current_time`, `holidays`, `is_holiday` |
| 地图与位置 | `geocode`, `reverse_geocode`, `route`, `my_ip` |
| 食品与健康 | `food_by_barcode`, `recipe_search`, `recipe_by_id`, `drug_info`, `recalls` |
| 体育 | `sports_scores`, `fixtures` |
| 实用工具 | `make_qr`, `shorten_url` |
| 系统 | `status` |
### 2级 - 可选免费API密钥
| 工具 | 提供商 |
| --- | --- |
| `stock_quote` | Finnhub |
| `economic_indicator` | FRED |
| `headlines` | NewsAPI |
| `nutrition` | Nutritionix |
| `flight_status` | AviationStack |
| `movie_tv_info` | TMDB |
如果必需的密钥未配置,这些工具会返回一个简短的消息,说明如何启用它们,而不是失败。
## 配置API密钥
```bash
npx alltag configure
```
配置单个提供商:
```bash
npx alltag configure finnhub
```
查看已配置的提供商:
```bash
npx alltag status
```
删除存储的凭证:
```bash
npx alltag reset [provider]
```
在保存密钥之前,配置过程会与提供商进行验证。无效或无法访问的凭证不会被存储。
### 存储优先级
凭证按以下顺序解析:
1. 环境变量
2. 操作系统密钥链
3. 应用程序配置目录中的 `.env` 文件
密钥永远不会被记录,只会发送到需要它们的服务。
## 数据源
### 默认包含
- Open-Meteo
- USGS
- Frankfurter
- CoinGecko
- Nager.Date
- TimeAPI
- OpenStreetMap Nominatim
- Open-Meteo Geocoding
- OSRM
- Trevorblades Countries
- Open Food Facts
- TheMealDB
- openFDA
- TheSportsDB
- Hacker News
- Wikipedia
- Free Dictionary
- ipapi
- qrserver
- TinyURL
### 可选提供商
- Finnhub
- FRED
- NewsAPI
- Nutritionix
- AviationStack
- TMDB
## 开发
安装依赖项:
```bash
npm install
```
构建项目:
```bash
npm run build
```
运行MCP服务器:
```bash
npm start
```
查看已配置的提供商:
```bash
npm run status
```