Chillax MCP Server

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-server

2.设置环境

# 実行環境向け依存関係インストール
uv sync

# 開発環境向けの依存関係インストール
uv sync --only-dev

3. 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您可以编辑词典，自定义每个天气的搜索关键字。

🤝 分发

欢迎拉要求！

1. 分叉此存储库
2. 创建特征分支（git checkout -b feature/amazing-feature)
3. 提交更改（git commit -m 'Add some amazing feature')
4. 推到分支（git push origin feature/amazing-feature)
5. 创建拉式请求

📄 许可证

这个项目MIT在许可证下公开。了解更多信息许可证请看文件。

🙏 谢辞

• OpenWeatherMap -天气数据API
• YouTube数据API - 動画検索API
• FastMCP - MCP 服务器实施框架

📞 联系我们

如果您有问题或建议问题请随便到！

______________________________________________________________________

与Chillax一起享受完美的一天！ 🌈