内容
# 本地数据MCP连接器
一款开源的、高度安全的、离线优先的 **模型上下文协议（MCP）服务器**，旨在为AI代理（如Claude Desktop、Antigravity或Cursor）提供只读访问权限，以查询您的本地日历、电子邮件和CSV日志。
这使得您的本地AI助手可以帮助您计划会议、总结客户电子邮件和分析健身/财务日志，而无需将任何私人文件上传到云端。
---
## 🔒 安全与隐私
1. **100%离线解析：** 所有处理过程都在您的CPU上使用Python标准库本地完成。
2. **严格只读：** 服务器仅暴露查询/读取工具。 它无法修改、删除或创建本地文件。
3. **自动Git保护：** 项目的`.gitignore`预先配置，以阻止日历（`.ics`）、电子邮件（`.eml`/`.mbox`）和CSV数据文件被意外提交到您的公共GitHub个人资料。
4. **零依赖：** 在标准Python库上运行（运行时无需`pip install`，使其高度安全和轻量级）。
---
## 🚀 快速入门
### 1. 先决条件
- **Python 3.10+**
### 2. 克隆仓库
```bash
git clone https://github.com/yourusername/local-data-mcp-connector.git
cd local-data-mcp-connector
```
### 3. 运行自动化单元测试
验证解析器在合成测试数据集上正确工作：
```bash
python test_connector.py
```
---
## 🛠️ 注册MCP服务器
配置您的AI桌面客户端通过stdio执行此服务器。
### 对于Claude Desktop
将以下内容添加到 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"local-data-mcp-connector": {
"command": "python",
"args": [
"C:\\path\\to\\local-data-mcp-connector\\mcp_connector.py"
]
}
}
}
```
*（确保将路径替换为克隆仓库的绝对路径）*
### 对于Google Antigravity
将以下内容添加到 `~/.gemini/config/mcp_config.json`：
```json
{
"mcpServers": {
"local-data-mcp-connector": {
"command": "python",
"args": [
"C:\\path\\to\\local-data-mcp-connector\\mcp_connector.py"
]
}
}
}
```
---
## 🛠️ 暴露的MCP工具
服务器暴露以下工具：
1. `query_calendar(file_path, query)`: 读取本地`.ics`日历文件，搜索事件摘要和描述。
2. `query_email(file_path, query)`: 加载`.eml`电子邮件，返回主题、发件人、日期和纯文本摘要。
3. `query_mbox_archive(file_path, query)`: 扫描`.mbox`本地文件夹（由Thunderbird、Google Takeout等使用）以列出匹配的电子邮件。
4. `query_csv_log(file_path, query_column, query_value, row_limit)`: 查询本地`.csv`电子表格（例如健身数据、银行导出）中的行。
