与您的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" # optionalAzure 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" # optionalClaude 桌面集成
添加到你的 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)
"故障排除
常见问题
- 导入错误确保所有依赖项都已安装
pip install -r requirements.txt - 大型语言模型API错误请验证您的API密钥是否设置正确且拥有足够的信用额度
- 权限错误某些系统命令可能需要提升的权限
- 命令超时为安全起见，长时间运行的诊断将在15秒后自动终止
调试日志记录
启用调试日志以排查问题：
export LOG_LEVEL=DEBUG
python server.py日志被写入到 ~/mcp_server.log 用于持续调试。
做出贡献
- 为仓库创建分支（或：克隆仓库）
- 创建一个特性分支：
git checkout -b feature-name - 进行更改并进行彻底测试
- 确保所有安全检查均通过
- 提交一个拉取请求
请确保任何新命令或功能都遵循安全至上的原则，并包含适当的安全检查。
许可证
GNU许可证 - 请参阅 许可证 详情请见文件。
支持
- GitHub Issues（GitHub问题）: 报告错误或提出功能需求
- 文档： 完整文档
- 讨论： 社区讨论
更新日志
v0.1.1
- 首次发布
- 跨平台系统诊断、设置检索和故障排除
- 支持OpenAI、Claude和Azure OpenAI
- 内置的安全功能和命令验证
- Claude Desktop 与 VS Code 的集成
______________________________________________________________________
注这个MCP服务器会在您的本地机器上执行系统命令。虽然已经采取了全面的安全措施，但请务必审查正在执行的命令，并确保您信任正在使用的具有系统级访问权限的AI助手。