MCP服务器集合

我的MCP服务器

一组定制的MCP（模型上下文协议）服务器，提供各种服务，包括日历管理和天气信息。

有关构建MCP服务器的更多信息，请参阅 MCP官方文件.

特性

• 日历服务：与Google Calendar API集成，用于事件管理
• 气象局：天气信息和预报能力
• 声音控制服务：macOS上音乐应用程序的基本播放控件
• Cosmos数据库服务：从Azure Cosmos DB容器中检索文档

系统要求

• Python 3.10或更高版本
• MCP SDK 1.2.0或更高版本
• Google日历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日历API凭证放入 credentials.json
   • 要获取您的凭据，请按照以下步骤操作 Google日历API Python快速入门指南 注意：首次使用日历服务时，将自动生成身份验证令牌。

服务

日历服务

日历服务提供与Google日历的集成，允许您：

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

气象局

气象服务提供：

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

声音控制服务

此服务为macOS提供了简单的播放控件。它可以：

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

Cosmos数据库服务

Cosmos DB服务连接到Azure Cosmos DB，并允许检索 文件由他们 id。连接信息是从Azure安全加载的 初始化过程中的密钥保管库机密。

用法

使用Azure资源初始化服务：

• keyvault_name：您的Azure密钥库名称（例如“我的密钥库”）
• 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许可证获得许可-请参阅 许可证 文件以获取详细信息。