Csv Editor

🚀 CSV Editor - 基於MCP的AI驅動CSV處理工具

CSV Editor 是一款高性能的MCP服務器，它能讓Claude、ChatGPT等AI助手通過簡單命令實現強大的數據操作能力，徹底改變AI助手處理CSV數據的方式。

🚀 快速開始

快速演示

# 現在你的AI助手可以這樣操作：
"加載銷售數據並去除重複項"
"篩選2024年第四季度交易額超過10000美元的交易記錄"
"計算價格和數量之間的相關性"
"用中位數填充缺失值"
"將分析結果導出為Excel文件"

# 所有操作都具備自動歷史記錄跟蹤和撤銷功能！

通過Smithery安裝

要通過 Smithery 為Claude Desktop自動安裝 csv-editor，請執行以下命令：

npx -y @smithery/cli install @santoshray02/csv-editor --client claude

最快安裝方式（推薦）

# 若需要，安裝uv（一次性設置）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆並運行
git clone https://github.com/santoshray02/csv-editor.git
cd csv-editor
uv sync
uv run csv-editor

配置你的AI助手

{
  "mcpServers": {
    "csv-editor": {
      "command": "uv",
      "args": ["tool", "run", "csv-editor"],
      "env": {
        "CSV_MAX_FILE_SIZE": "1073741824"
      }
    }
  }
}

✨ 主要特性

解決的問題

AI助手在處理複雜數據操作時面臨困難，它們雖然可以讀取文件，但缺乏有效過濾、轉換、分析和驗證CSV數據的工具。

解決方案

CSV Editor彌補了這一差距，它為AI助手提供了40多種專門用於CSV操作的工具，使其成為強大的數據分析師，能夠：

• 數秒內清理雜亂的數據集
• 執行復雜的統計分析
• 自動驗證數據質量
• 使用自然語言命令轉換數據
• 通過撤銷/重做功能跟蹤所有更改

關鍵差異化特性

💻 使用示例

基礎用法

# 你的AI助手現在可以這樣做：
"Load the sales data and remove duplicates"
"Filter for Q4 2024 transactions over $10,000"  
"Calculate correlation between price and quantity"
"Fill missing values with the median"
"Export as Excel with the analysis"

# 所有操作都具備自動歷史記錄跟蹤和撤銷功能！

高級用法

數據分析師工作流

# 早上：加載昨天的數據
session = load_csv("daily_sales.csv")

# 清理：去除重複項並修正數據類型
remove_duplicates(session_id)
change_column_type("date", "datetime")
fill_missing_values(strategy="median", columns=["revenue"])

# 分析：獲取洞察
get_statistics(columns=["revenue", "quantity"])
detect_outliers(method="iqr", threshold=1.5)
get_correlation_matrix(min_correlation=0.5)

# 報告：導出清理後的數據
export_csv(format="excel", file_path="clean_sales.xlsx")

ETL管道

# 從多個來源提取數據
load_csv_from_url("https://api.example.com/data.csv")

# 進行復雜的轉換操作
filter_rows(conditions=[
    {"column": "status", "operator": "==", "value": "active"},
    {"column": "amount", "operator": ">", "value": 1000}
])
add_column(name="quarter", formula="Q{(month-1)//3 + 1}")
group_by_aggregate(group_by=["quarter"], aggregations={
    "amount": ["sum", "mean"],
    "customer_id": "count"
})

# 加載到不同的格式
export_csv(format="parquet")  # 用於數據倉庫
export_csv(format="json")     # 用於API

數據質量保證

# 驗證傳入的數據
validate_schema(schema={
    "customer_id": {"type": "integer", "required": True},
    "email": {"type": "string", "pattern": r"^[^@]+@[^@]+\.[^@]+$"},
    "age": {"type": "integer", "min": 0, "max": 120}
})

# 質量評分
quality_report = check_data_quality()
# 返回：總體評分、缺失數據百分比、重複項、異常值

# 異常檢測
anomalies = find_anomalies(methods=["statistical", "pattern"])

📚 詳細文檔

可用工具

配置

環境變量

自動保存策略

CSV Editor可以通過可配置的策略自動保存你的工作：

• 覆蓋（默認） - 更新原始文件
• 備份 - 創建帶時間戳的備份
• 版本化 - 維護版本歷史
• 自定義 - 保存到指定位置

# 配置自動保存
configure_auto_save(
    strategy="backup",
    backup_dir="/backups",
    max_backups=10
)

高級安裝選項

git clone https://github.com/santoshray02/csv-editor.git
cd csv-editor
pip install -e .

pipx install git+https://github.com/santoshray02/csv-editor.git

# 安裝最新版本
pip install git+https://github.com/santoshray02/csv-editor.git

# 或者使用uv
uv pip install git+https://github.com/santoshray02/csv-editor.git

# 安裝特定版本
pip install git+https://github.com/santoshray02/csv-editor.git@v1.0.1

🔧 技術細節

運行測試

uv run test           # 運行測試
uv run test-cov       # 帶覆蓋率
uv run all-checks     # 格式化、檢查代碼風格、類型檢查和測試

項目結構

csv-editor/
├── src/csv_editor/   # 核心實現
│   ├── tools/        # MCP工具實現
│   ├── models/       # 數據模型
│   └── server.py     # MCP服務器
├── tests/            # 測試套件
├── examples/         # 使用示例
└── docs/            # 文檔

🤝 貢獻代碼

我們歡迎貢獻！請參考 CONTRIBUTING.md 獲取貢獻指南。

快速貢獻指南

1. 分叉倉庫
2. 創建功能分支
3. 編寫測試並進行更改
4. 運行 uv run all-checks
5. 提交拉取請求

📈 路線圖

• [ ] SQL查詢接口
• [ ] 即時協作
• [ ] 高級可視化
• [ ] 機器學習集成
• [ ] 雲存儲支持
• [ ] 針對10GB以上文件的性能優化

💬 支持

• 問題反饋：GitHub Issues
• 討論：GitHub Discussions
• 文檔：Wiki

📄 許可證

本項目採用MIT許可證，請參閱 LICENSE 文件獲取詳細信息。

🙏 致謝

本項目基於以下工具構建：

• FastMCP - 快速模型上下文協議
• Pandas - 數據操作
• NumPy - 數值計算

準備好提升你的AI數據處理能力了嗎？ 兩分鐘內開始使用 →