Dank MCP

🚀 dank - mcp

dank-mcp 是一個實驗性的開源工具，主要為特定領域的數據分析提供支持。它通過爬取、清洗和存儲數據，同時提供機器可讀規範（MCP）服務接口，來滿足數據分析的需求。

🚀 快速開始

dank-mcp 是一個實驗性的開源工具，旨在為特定領域的數據分析提供支持。用戶可通過以下步驟快速上手該項目：

# 克隆倉庫
git clone https://github.com/AgentDank/dank-mcp.git
cd dank-mcp

# 安裝依賴
go mod tidy

# 啟動服務
./dank-mcp

✨ 主要特性

• 數據獲取與存儲：支持從 ct.data.gov 等數據源獲取公開數據，並將其存儲在 DuckDB 數據庫中。默認數據庫文件為 dank-mcp.duckdb，支持內存模式和文件模式。
• 數據清洗：考慮到上游數據可能存在質量問題，項目提供了數據清洗功能，主要處理包括刪除異常字符、處理檢測到的“trace”值（視為0）、過濾明顯錯誤的數據項。
• MCP 服務接口：實現了自定義的 MCP 服務器，允許通過 HTTP 或 SSE 協議進行交互。

📦 安裝指南

克隆與依賴安裝

# 克隆倉庫
git clone https://github.com/AgentDank/dank-mcp.git
cd dank-mcp

# 安裝依賴
go mod tidy

啟動服務

./dank-mcp

指定 DuckDB 文件路徑

# 指定DuckDB文件路徑
./dank-mcp --db /path/to/database.db

啟動數據下載和清洗

# 啟動數據下載和清洗
./dank-mcp --dump

使用 SSE 協議提供服務

# 使用SSE協議提供服務
./dank-mcp --sse-host 0.0.0.0:8080

💻 使用示例

基礎用法

# 下載並運行Docker鏡像（需先構建鏡像）
docker build -t dank-mcp .
docker run -it --rm Dank-Mcp

高級用法

用戶可以通過配置參數自定義行為，例如指定數據抓取的 API 令牌：

# 設置API令牌並啟動服務
./dank-mcp --token your_api_token_here

📚 詳細文檔

項目架構

• 數據獲取層：負責從指定接口抓取公開數據。
• 數據處理層：執行數據清洗和預處理操作。
• 存儲層：使用 DuckDB 進行數據持久化。
• 服務層：提供 MCP 標準接口，支持多種傳輸協議。

注意事項

⚠️ 重要提示

• 日誌記錄：默認情況下，日誌輸出到標準錯誤流。用戶可以通過 --log-file 參數指定日誌文件。
• 數據一致性：項目依賴的數據源可能存在延遲或變更，建議定期同步數據。

項目背景與展望

dank-mcp 是一個快速實驗項目，旨在探索 MCP 技術在特定領域的應用潛力。未來計劃擴展其功能，包括支持更多數據源、增強數據清洗規則、提供多模態數據處理能力（如圖像分析）。

貢獻指南

歡迎社區貢獻代碼和問題反饋。請遵循項目 CODE_OF_CONDUCT.md 規範，保持良好的協作環境。

📄 許可證

本項目由 Neomantra Corp. 於2025年授權，採用 MIT License 開源協議，詳細內容見 LICENSE.txt。

團隊介紹

dank-mcp 是由 AgentDank 團隊開發的開源項目。我們致力於通過技術創新推動數據分析領域的進步，歡迎更多志同道合的朋友加入！