用于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客户端启动和管理。您不能单独运行它。
- 克隆存储库：
git clone https://github.com/dhofer/mcp-server-kontomanager.git- 配置您的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网站结构可能随时发生变化，这可能会破坏此服务器的功能。使用风险自负。*