My MCP Servers

我的 MCP 服务

一组自定义 MCP（Model Context Protocol）服务，提供日历管理和天气信息等各种服务。

有关构建 MCP 服务的更多信息，请参阅 MCP 官方文档。

功能

• 日历服务：集成 Google Calendar API，用于管理事件
• 天气服务：提供天气信息和预报功能
• 声音控制服务：macOS 上 Music 应用的基本播放控制
• Cosmos DB 服务：从 Azure Cosmos DB 容器中检索文档

系统要求

• Python 3.10 或更高版本
• MCP SDK 1.2.0 或更高版本
• Google Calendar API 凭据（credentials.json）

环境设置

1. 安装 uv（MacOS/Linux）：

curl -LsSf https://astral.sh/uv/install.sh | sh

注意：安装 uv 后请重启终端，以确保命令可用。

2. 克隆代码库：

git clone <your-repository-url>
cd my-mcp-servers

3. 同步环境：

uv sync

4. 测试是否正常运行：

uv run weather/weather.py

配置

1. 将 Google Calendar API 凭据放入 credentials.json
   • 若要获取凭据，请参阅 Google Calendar API Python 快速入门指南 注意：首次使用日历服务时，将自动生成身份验证令牌。

服务

日历服务

日历服务集成了 Google Calendar，可用于：

• 创建和管理日历事件
• 列出即将举行的事件
• 设置定期会议

天气服务

天气服务提供：

• 天气预报
• 天气警报
• 基于位置的天气信息

声音控制服务

此服务提供 macOS 的简单播放控制功能。它可以：

• 播放或暂停当前曲目
• 跳到下一首曲目
• 返回上一首曲目

Cosmos DB 服务

Cosmos DB 服务连接到 Azure Cosmos DB，并允许通过 id 检索 文档。初始化期间，会从 Azure Key Vault 密钥中安全加载连接信息。

用法

使用 Azure 资源初始化服务：

• keyvault_name：Azure Key Vault 名称（例如，“my-keyvault”）
• secret_name：包含 Cosmos DB 连接字符串的密钥名称
• database_name：目标 Cosmos DB 数据库名称
• container_name：数据库中的目标容器名称

初始化示例：

# The service will automatically connect using DefaultAzureCredential
# Ensure your environment has proper Azure authentication configured
await initialize(
    keyvault_name="my-company-keyvault",
    secret_name="cosmos-connection-string", 
    database_name="production-db",
    container_name="documents"
)

初始化后，你可以通过 ID 检索文档：

# Retrieve a document by its ID
document = await get_document_by_id("user-123")

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。