使用说明
OS-MCP——笔记本电脑文件系统MCP服务器
一 MCP（模型上下文协议） 服务器，使任何兼容的AI代理都能安全、可预测地与笔记本电脑的文件系统进行交互。
它做什么
| 工具 | 人工智能能做什么 |
|---|---|
create_directory |
在系统上的任何位置创建文件夹（以及任何父文件夹） |
path_exists |
检查文件是否 或 目录存在于给定的路径中 |
copy_file |
将单个文件从一个位置复制到另一个位置 |
copy_directory |
递归复制整个文件夹树 |
项目结构
os-mcp/
├── server.py ← MCP server (all tools live here)
├── pyproject.toml ← Package metadata
├── test_server.py ← Quick sanity-check script
├── venv/ ← Python virtual environment
└── README.md ← This file
快速开始
1--激活虚拟环境
# from the os-mcp folder
.\venv\Scripts\Activate.ps1
2--手动运行服务器（stdio模式）
python server.py
服务器使用MCP stdio协议——它等待来自主机的JSON-RPC消息，并在stdout上进行回复。你不会看到提示；这很正常。
3--将其连接到Claude Desktop（或任何MCP主机）
将以下块添加到Claude Desktop配置文件中
(%APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"os-mcp": {
"command": "C:\\Users\\Samruddhi\\Documents\\CODING_AND_PROJECTS\\os-mcp\\venv\\Scripts\\python.exe",
"args": [
"C:\\Users\\Samruddhi\\Documents\\CODING_AND_PROJECTS\\os-mcp\\server.py"
]
}
}
}
重新启动Claude Desktop，四个工具将立即可用。
工具参考
create_directory
create_directory(path: str) -> str
在以下位置创建目录 path 加上任何缺失的父目录(mkdir -p 风格）。
示例提示： “创建文件夹C:\Projects\MyApp\logs”
path_exists
path_exists(path: str) -> str
返回文件或目录是否存在，以及其类型和（对于文件）大小。
示例提示： “C:\Users\Samruddhi\Downloads\report.pdf是否存在？”
copy_file
copy_file(source: str, destination: str) -> str
复制单个文件。如果 destination 是一个目录，文件以其原始名称放置在其中。父目录是自动创建的。文件元数据（时间戳、权限）被保留。
示例提示： “将C:\notes.txt复制到C:\Backup\notes.txt”
copy_directory
copy_directory(source: str, destination: str, overwrite: bool = False) -> str
递归复制整个目录树。通过 overwrite=True 以替换现有目的地。
示例提示： “将我的C:\Projects\OldApp文件夹复制到C:\Archive\OldApp”
运行测试套件
.\venv\Scripts\python.exe test_server.py
所有测试都在一个一次性临时目录中运行，并自行清理。
