AI导哈

PC诊断与故障排除服务

一个通过AI助手（如Claude、ChatGPT或任何MCP兼容工具）进行PC诊断和故障排除的模型上下文协议（MCP）服务器。

  • by Irene-123
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Irene-123/talk-to-your-pc-mcp-server

使用说明

与您的PC MCP服务器通信

一个模型上下文协议（MCP）服务器，它通过如Claude、ChatGPT或任何MCP兼容工具等AI助手来诊断和解决您的PC问题。

特点/功能

  • 系统诊断自动诊断计算机问题和性能问题
  • PC设置管理检查音量、WiFi网络、电池状态、系统信息等
  • 安全故障排除执行系统修复命令，同时内置安全检查
  • 跨平台支持适用于Windows（PowerShell）、macOS和Linux（bash）
  • **支持多个大型语言模型（LLM）**兼容OpenAI、Claude/Anthropic以及Azure OpenAI
  • 安全至上内置命令验证和危险操作阻止功能

工具

run_diagnosis

运行系统诊断以识别计算机可能存在的问题。

示例用法：

  • “为什么我的电脑运行这么慢？”
  • “检查我的网络连接”
  • “诊断内存使用问题”

get_pc_settings

获取PC设置和系统信息，如音量、WiFi、电池等。

示例用法：

  • “我连接的是哪个WiFi网络？”
  • “显示我的电池百分比”
  • “我当前的IP地址是什么？”
  • “检查我的磁盘空间”

execute_troubleshooting

执行故障排除命令以安全地修复系统问题。

示例用法：

  • “修复我的DNS问题”
  • “重置我的网络适配器”
  • “清除系统缓存”
  • “重启音频服务”

安装

方法1：使用PyPI（推荐）

pip install talk-to-pc-mcp

方法2：从源（处）获取

git clone https://github.com/Irene-123/talk-to-your-pc-mcp-server.git
cd talk-to-your-pc-mcp-server
pip install -e .

配置

大型语言模型（LLM）API设置

通过设置相应的环境变量来配置您偏好的大型语言模型（LLM）提供商：

OpenAI（一家人工智能研究实验室）

export OPENAI_API_KEY="sk-..."
export OPENAI_MODEL="gpt-4"  # optional, defaults to gpt-3.5-turbo

克劳德/人类（注：此处“Anthropic”在人工智能领域常指“Anthropic, Inc.”，一家开发大型语言模型公司的名称，但直接翻译为“人类”在语境上可能产生歧义，若需更准确的翻译，需结合具体上下文。若保持原样作为专有名词，则译为“克劳德/Anthropic”）

export ANTHROPIC_API_KEY="sk-ant-..."
export ANTHROPIC_MODEL="claude-3-haiku-20240307"  # optional

Azure OpenAI

export AZURE_OPENAI_API_KEY="your-key"
export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com/"
export AZURE_OPENAI_DEPLOYMENT_NAME="gpt-35-turbo"
export AZURE_OPENAI_API_VERSION="2024-02-15-preview"  # optional

Claude 桌面集成

添加到你的 claude_desktop_config.json：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "talk-to-pc": {
      "command": "talk-to-your-pc-mcp-server",
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code 集成

对于配备了 GitHub Copilot 的 VS Code，请在您的 VS Code 设置或 MCP 配置中添加：

{
  "mcp.servers": {
    "talk-to-pc": {
      "command": "talk-to-your-pc-mcp-server"
    }
  }
}

使用示例

配置完成后，您可以通过您的AI助手使用自然语言与您的电脑进行交互：

系统诊断

  • “我的电脑运行得很慢，你能帮我诊断一下问题吗？”
  • “检查一下为什么我的网络连接不稳定”
  • “分析我的系统性能”

PC 设置

  • “有哪些可用的WiFi网络？”
  • “显示我当前的系统规格”
  • “我的电量还剩多少？”
  • “检查我的音频音量设置”

故障排除

  • “我的WiFi连不上，请帮忙解决一下。”
  • “清除我的DNS缓存”
  • “重启我的音频服务”
  • “修复网络连接问题”

安全特性

  • 命令验证所有命令在执行前均经过验证
  • 危险的命令阻塞防止执行可能有害的命令，如 rm -rf， format， del /f
  • 超时保护命令将在15秒后自动终止
  • 跨平台安全性针对Windows、macOS和Linux的操作系统特定安全检查
  • 用户透明度所有执行的命令和输出结果均展示给用户以供验证

平台特定行为

Windows

  • 使用 PowerShell 执行命令
  • 支持Windows特定的诊断工具（事件查看器、WMI等）
  • 通过网络进行管理 netsh 命令

macOS/Linux

  • 使用 bash 执行命令
  • 支持Unix风格的系统工具（ps， netstat， iwconfig等
  • 在适当的情况下集成包管理器

发展

从源代码运行

# Clone the repository
git clone https://github.com/Irene-123/talk-to-your-pc-mcp-server.git
cd talk-to-your-pc-mcp-server

# Install dependencies
pip install -r requirements.txt

# Set your API key
export ANTHROPIC_API_KEY="your-key-here"

# Run the server
python server.py

测试

# Test with MCP Inspector
npx @modelcontextprotocol/inspector python server.py

# Or test individual functions
python -c "
import asyncio
from server import get_pc_settings
result = asyncio.run(get_pc_settings('check WiFi status'))
print(result)
"

故障排除

常见问题

  1. 导入错误确保所有依赖项都已安装 pip install -r requirements.txt
  2. 大型语言模型API错误请验证您的API密钥是否设置正确且拥有足够的信用额度
  3. 权限错误某些系统命令可能需要提升的权限
  4. 命令超时为安全起见，长时间运行的诊断将在15秒后自动终止

调试日志记录

启用调试日志以排查问题：

export LOG_LEVEL=DEBUG
python server.py

日志被写入到 ~/mcp_server.log 用于持续调试。

做出贡献

  1. 为仓库创建分支（或：克隆仓库）
  2. 创建一个特性分支： git checkout -b feature-name
  3. 进行更改并进行彻底测试
  4. 确保所有安全检查均通过
  5. 提交一个拉取请求

请确保任何新命令或功能都遵循安全至上的原则，并包含适当的安全检查。

许可证

GNU许可证 - 请参阅 许可证 详情请见文件。

支持

更新日志

v0.1.1

  • 首次发布
  • 跨平台系统诊断、设置检索和故障排除
  • 支持OpenAI、Claude和Azure OpenAI
  • 内置的安全功能和命令验证
  • Claude Desktop 与 VS Code 的集成

注这个MCP服务器会在您的本地机器上执行系统命令。虽然已经采取了全面的安全措施，但请务必审查正在执行的命令，并确保您信任正在使用的具有系统级访问权限的AI助手。

相关 MCP