Chillax MCP服务器🌤️🎬
最适合天气的YouTube建议视频MCP服务器。外面是晴天？那么请看户外视频。下雨了吗？一边听爵士乐一边读书怎么样？我会帮你把你的一天变成最棒的天气。
🌟 特徴
- 天气连动: OpenWeatherMap API根据取得的天气信息提出视频
- 多言语对应：根据城市名称自动判定语言（现在对应的是日语、英语、韩语、中文）
- 细致的建议：应对晴、雨、酷暑、极寒、暴风雨等各种天气
- 级联处理: API将条目添加到文档注册表API用于输入的实际示例
📋 需要的东西
- Python 3.10以上
- OpenWeatherMap API密钥 （免费计划OK）
- YouTube数据API v3密钥 （有免费名额）
- 紫外线 （Python包管理器）
🚀 快速启动
1.克隆存储库
git clone https://github.com/0xshooka/chillax-mcp-server.git
cd chillax-mcp-server2.设置环境
# 実行環境向け依存関係インストール
uv sync
# 開発環境向けの依存関係インストール
uv sync --only-dev3. API设置关键帧
.env已创建和检索文件API设置关键帧。
# .env
OPENWEATHER_API_KEY=your_openweather_api_key_here
YOUTUBE_API_KEY=your_youtube_api_key_here🔧 使用方法
Claude Desktop中的设置
claude_desktop_config.json中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长。
{
"mcpServers": {
"chillax-mcp-server": {
"command": "/path/to/uv",
"args": [
"--directory",
"/path/to/chillax-mcp-server",
"run",
"chillax.py"
]
}
}
}可用工具
get_activity_suggestion
以级联方式进行天气取得和视频提案。（天气取得→视频提案的顺序）
パラメータ:
- city: 都市名
- days_ahead: 何日後か
戻り値:
- 天気情報と動画提案の統合結果使用例
You: 明日の東京の過ごし方を提案して
LLM: 明日の東京の天気を確認して、最適な過ごし方を提案しますね。
[get_activity_suggestion関数を実行]
明日の東京は晴れ時々曇り、最高気温24℃の過ごしやすい天気になりそうです！
外出を楽しむのに最適な日ですね。
おすすめの動画をご紹介します：
1. 「東京の隠れた公園散歩スポット10選」- 都内の穴場公園を紹介
2. 「初心者向けサイクリングコース 多摩川編」- 気持ちいい川沿いコース
...🧪 开発
代码质量检查
# リンター
uv run ruff check .
# フォーマッター
uv run black .
# 型チェック
uv run mypy .测试
# 全テスト実行
uv run pytest
# カバレッジ付き
uv run pytest --cov📝 自定义
添加新语言
CITY_LANGUAGE_MAP中添加城市和语言映射的描述示例如下。
CITY_LANGUAGE_MAP = {
# フランス
"paris": Language.FR,
"lyon": Language.FR,
...
}自定义天气类别
categorize_weather函数，您可以添加新的天气判断逻辑。
调整搜索查询
SEARCH_QUERIES您可以编辑词典，自定义每个天气的搜索关键字。
🤝 分发
欢迎拉要求！
- 分叉此存储库
- 创建特征分支（
git checkout -b feature/amazing-feature) - 提交更改（
git commit -m 'Add some amazing feature') - 推到分支（
git push origin feature/amazing-feature) - 创建拉式请求
📄 许可证
这个项目MIT在许可证下公开。了解更多信息许可证请看文件。
🙏 谢辞
- OpenWeatherMap -天气数据API
- YouTube数据API - 動画検索API
- FastMCP - MCP 服务器实施框架
📞 联系我们
如果您有问题或建议问题请随便到！
______________________________________________________________________
与Chillax一起享受完美的一天！ 🌈