Vienna Live MCP

维也纳实时MCP服务器

   

一个全面的MCP服务器，通过整合的组合工具提供对维也纳生活助理功能的编程访问。

概述

这 维也纳直播mcp 服务器将维也纳生活助理转换为完全可编程的个人助理。它实现了 波特曼托图案 在5个逻辑类别中组织63个工具，为以下对象提供干净、可发现的API：

• 购物管理 -商店优惠、购物清单、预算跟踪
• 旅行计划 -交通时间表、行程规划、天气综合
• 费用跟踪 -财务管理、预算分析、支出洞察
• 媒体管理 -统一访问Plex、Calibre和Immich库
• 个人计划 -待办事项管理、日历、目标和生产力工具

建筑

波特曼托图案

每个组合都为特定领域提供了一组有凝聚力的工具：

graph TD
    A[Vienna Live MCP Server] --> B[shopping_manager]
    A --> C[travel_manager]
    A --> D[expenses_manager]
    A --> E[media_manager]
    A --> F[planning_manager]

    B --> B1[get_store_offers]
    B --> B2[compare_prices]
    B --> B3[shopping_list_create]

    C --> C1[get_next_tram]
    C --> C2[plan_day_trip]
    C --> C3[get_train_schedule]

    D --> D1[add_expense]
    D --> D2[analyze_spending_patterns]
    D --> D3[set_budget]

    E --> E1[search_plex_library]
    E --> E2[search_calibre_library]
    E --> E3[search_immich_photos]

    F --> F1[create_todo]
    F --> F2[get_productivity_stats]
    F --> F3[set_goal]

双重运输支持

服务器支持两种MCP传输：

• STDIO传输：用于与MCP客户端（Cursor、Claude Desktop等）集成
• HTTP传输：用于直接web API访问和web应用程序集成

快速开始

先决条件

• Python 3.11+
• 数据库：SQLite（默认，无需设置）或PostgreSQL（可选，用于生产）
• 可选外部API:

- 维也纳API（维也纳公共交通） - OpenWeatherMap API（天气数据） - 货币兑换API - BB API（奥地利铁路） - Plex、Calibre、Immich API（媒体服务）

备注：默认情况下，服务器使用模拟数据。真正的API集成是可选的，需要API密钥。

安装

先决条件

• 紫外线 已安装（推荐）
• Python 3.12+

快速开始

立即通过运行 uvx:

uvx vienna-live-mcp

Claude桌面集成

添加到您的 claude_desktop_config.json:

"mcpServers": {
  "vienna-live-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/vienna-live-mcp", "run", "vienna-live-mcp"]
  }
}

运行服务器

STDIO模式（MCP客户端集成）：

python -m vienna_live_mcp.server

HTTP模式（直接API访问）：

python -m vienna_live_mcp.server --transport http --port 8000

工具类别

购物经理（11个工具）

差旅经理（15个工具）

费用管理器（12个工具）

媒体管理器（10个工具）

计划经理（15种工具）

配置

环境变量

# Database Configuration
DATABASE_URL=postgresql://user:password@localhost:5432/vienna_life_assistant

# External API Keys
WIENER_LINIEN_API_KEY=your_wiener_linien_key
OPENWEATHER_API_KEY=your_weather_key
CURRENCY_API_KEY=your_currency_key

# Media Service URLs
PLEX_SERVER_URL=http://plex.local:32400
PLEX_TOKEN=your_plex_token
CALIBRE_URL=http://calibre.local:8080
IMMICH_URL=http://immich.local:2283
IMMICH_API_KEY=your_immich_key

# Redis (for background tasks)
REDIS_URL=redis://localhost:6379/0

服务集成

该服务器与Vienna Life Assistant的生态系统集成：

• 数据库：与web应用程序共享PostgreSQL
• 维也纳 线：公共交通数据
• plex流媒体服务器：媒体服务器集成
• 卡利伯：电子书库访问
• 伊姆希：照片管理
• 天气API：旅行计划支持
• 货币API：差旅费计算

测试

# Run all tests
pytest

# Run with coverage
pytest --cov=vienna_live_mcp

# Run specific portmanteau tests
pytest tests/test_shopping_manager.py
pytest tests/test_travel_manager.py

MCPB包装

服务器支持MCPB（MCP二进制）打包，便于分发：

# Build MCPB package
mcpb build

# Install from MCPB
mcpb install vienna-live-mcp.mcpb

集成

MCP客户端集成

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    # Connect to vienna-live-mcp server
    server_params = StdioServerParameters(
        command="python",
        args=["-m", "vienna_live_mcp.server"]
    )

    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # Use shopping manager tools
            result = await session.call_tool("get_store_offers", {"store_name": "spar"})
            print(f"Spar offers: {result}")

            # Use travel manager tools
            tram_info = await session.call_tool("get_next_tram", {"station_name": "Stephansplatz"})
            print(f"Next tram: {tram_info}")

Web应用程序集成

Vienna Life Assistant网络应用程序与此MCP服务器集成，以增强功能：

// Example: Using MCP client in React
import { MCPClient } from '@vienna-life-assistant/mcp-client';

const client = new MCPClient({
  transport: 'http',
  baseURL: 'http://localhost:8000'
});

// Get shopping recommendations
const recommendations = await client.callTool('get_shopping_recommendations', {
  based_on: 'recent_purchases'
});

未来的增强功能

• 真正的API集成：与所有外部服务完全集成
• 机器学习：增强的人工智能建议和预测
• 多用户支持：用户隔离和权限
• 高级分析：深入洞察和趋势分析
• 移动SDK：本地移动应用程序集成
• 插件系统：可扩展的工具架构

🛡️ 工业级质量堆栈

该项目坚持 索塔14.1 高保真代理编排的工业标准：

• Python（核心）: 拉夫 用于裁剪和格式化。零容忍 print 核心处理程序中的语句(T201).
• Web应用程序（用户界面）: 生物群系 用于亚毫秒级的起毛。严格 noConsoleLog 执行。
• 协议遵从：硬化 stdout/stderr 隔离，以确保防崩溃的JSON-RPC通信。
• 自动化: Justfile 所有舰队行动的食谱(just lint, just fix, just dev).
• 安全：通过以下方式进行自动化审计 bandit 和 safety.

许可证

MIT许可证-请参阅 许可证 了解详情。

贡献

1. 分叉存储库
2. 创建要素分支
3. 添加新功能的测试
4. 提交拉取请求

支持

• 问题:
• 讨论:
• 文档: MCP中央文件

致谢

• 内置于 FastMCP
• 部分 维也纳生活助理 生态系统
• 跟随 MCP中央标准

______________________________________________________________________

维也纳制造