AI导哈

移动账户管理服务器

一个非官方的MCP服务器，用于管理奥地利移动品牌yesss!、Georg和XOXO的账户信息、账单下载和设置修改。

  • by dhofer
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 dhofer/mcp-server-kontomanager

使用说明

用于Kontomanager的MCP服务器

非官方 主控程序 奥地利移动品牌服务器 是的！, 乔治，以及 亲亲抱抱.

该服务器充当桥梁，通过一组结构化的MCP工具公开Kontomanager web界面的功能。它允许您以编程方式读取帐户信息、检查使用情况、下载账单以及修改呼叫转接等设置。

✨ 特性

此服务器设计有 工具优先 获得广泛客户支持的方法。它提供了一套全面的功能，反映了门户网站：

  • 读取帐户数据：获取使用情况、信用、计划详细信息、电话号码和通话记录。
  • 管理账单：列出过去的账单并下载其PDF内容。
  • 修改设置：更改SIM卡设置，如漫游，并配置详细的呼叫转移规则。
  • 高级工作流：使用简单的工具进行常见操作，如禁用语音邮件。

🛠️ 可用工具

服务器通过工具公开所有功能，MCP客户端或LLM可以调用这些工具。

数据检索工具

  • get_account_usage()：检索主账户概述，包括计划详细信息、使用统计信息和信用余额。
  • get_phone_numbers()：列出与登录帐户关联的所有电话号码。
  • list_bills()：获取可用账单列表（仅元数据）。
  • download_bill(bill_number, document_type)：获取特定账单或其逐项记录（EGN），并返回其二进制内容（PDF）。
  • get_call_history()：检索最近通话和短信的列表。
  • get_sim_settings()：读取所有SIM卡相关设置的当前状态（例如漫游状态、数据限制）。
  • get_call_forwarding_settings()：读取当前的呼叫转移和语音邮件设置。

操作和工作流工具

  • switch_active_phone_number(subscriber_id)：切换会话的活动电话号码。
  • toggle_roaming(enabled)：启用或禁用国际漫游的简单工具。
  • set_sim_setting(setting_name, enabled)：启用或禁用特定SIM卡设置的低级工具。
  • set_call_forwarding_rule(...)：一种配置特定呼叫转移规则的低级工具（例如，在忙时转移到特定号码）。

🗣️ 示例用法

您可以在兼容的MCP客户端中使用自然语言与此服务器交互。客户的LLM将选择并执行适当的工具。

  • “我目前的数据使用情况和信用额度是多少？”
    • → Calls get_account_usage()
  • “给我看看我最后几张账单。”
    • → Calls list_bills()
  • “下载我的8177号账单及其详细记录。”
    • → Calls download_bill(bill_number='8177', document_type='bill')
    • → Calls download_bill(bill_number='8177', document_type='egn')
  • “为我的旅行打开漫游。”
    • → Calls toggle_roaming(enabled=True)
  • “当我的电话占线时，将我所有的电话转接到+43681124567。”
    • → Calls set_call_forwarding_rule(condition='wtel', target='a', target_number='+436811234567')

⚙️ 配置

服务器需要您的Kontomanager凭据。这些必须通过环境变量提供，您将在MCP客户端的配置文件中设置这些变量。

所需变量为：

  • KONTOMANAGER_BRAND：您的移动运营商的品牌。支持的值： "yesss", "georg", "xoxo".
  • KONTOMANAGER_USERNAME：您的登录电话号码或用户名。
  • KONTOMANAGER_PASSWORD：您的Kontomanager帐户密码。

🚀 设置和使用

该项目是一个MCP服务器，旨在由MCP客户端启动和管理。您不能单独运行它。

  1. 克隆存储库：

    git clone https://github.com/dhofer/mcp-server-kontomanager.git

  2. 配置您的MCP客户端： 将新的服务器定义添加到MCP客户端的配置文件中。该命令将使用 uv run 从服务器的本地目录执行服务器。确保使用 绝对路径 到克隆的存储库。

    {
  "mcpServers": {
    "kontomanager": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp-server-kontomanager",
        "python",
        "src/server.py"
      ],
      "env": {
        "KONTOMANAGER_BRAND": "yesss",
        "KONTOMANAGER_USERNAME": "43681...",
        "KONTOMANAGER_PASSWORD": "your_secret_password"
      }
    }
  }
}

⚠️ 重要警告：使用前请阅读

数据隐私

当您使用此MCP服务器时，工具检索到的任何数据（如您的帐户使用情况、电话号码或账单详细信息）都会发送到为您的MCP客户端提供动力的大型语言模型（LLM）。 这意味着第三方公司（例如OpenAI、谷歌、Anthropic）将处理这些潜在的敏感信息。 请注意隐私问题，并在使用此服务器之前查看您的LLM提供商的政策。

财务风险

此服务器提供可以实时更改您的移动帐户设置的工具。行动如 toggle_roaming 或 set_call_forwarding_rule 可能导致 您的电话账单上有大量真实的费用尤其是如果配置错误。您全权负责因使用这些工具而产生的任何和所有费用。 请极其谨慎地使用它们。

🧑‍💻 发展理念

从所有意图和目的来看， vibe编码它是基于直觉和开发人员的特定需求而构建的。虽然它的目标是功能性的，但它可能不遵循最严格的工程实践，测试也有限。强烈建议使用Pull请求来提高健壮性、添加测试或改进代码！

免责声明： 这是一个非官方项目，不隶属于A1 Telekom Austria AG或其任何品牌，也不认可或支持该项目。Kontomanager网站结构可能随时发生变化，这可能会破坏此服务器的功能。使用风险自负。

相关 MCP