Dank MCP

🚀 dank-mcp

dank-mcp は、特定分野のデータ分析をサポートするための実験的なオープンソースツールです。データのクローリング、クリーニング、および保存を行い、機械可読規格（MCP）のサービスインターフェースを提供することで、この目的を達成します。

🚀 クイックスタート

ユーザーは以下のコマンドを使用してすぐに始めることができます。

# リポジトリをクローンする
git clone https://github.com/AgentDank/dank-mcp.git
cd dank-mcp

# 依存関係をインストールする
go mod tidy

# サービスを起動する
./dank-mcp

✨ 主な機能

データの取得と保存

dank-mcp は、ct.data.gov などのデータソースから公開データを取得し、DuckDB データベースに保存することができます。デフォルトのデータベースファイルは dank-mcp.duckdb で、メモリモードとファイルモードの両方をサポートしています。

# DuckDBファイルのパスを指定する
./dank-mcp --db /path/to/database.db

データクリーニング

上流のデータには品質問題がある可能性があるため、このプロジェクトではデータクリーニング機能を提供しています。主な処理内容は以下の通りです。

• 異常な文字を削除する
• 検出された「trace」値を0として扱う
• 明らかに誤ったデータ項目をフィルタリングする

# データのダウンロードとクリーニングを開始する
./dank-mcp --dump

MCP サービスインターフェース

このプロジェクトでは、カスタムの MCP サーバーが実装されており、HTTP または SSE プロトコルを使用してやり取りすることができます。

# SSEプロトコルを使用してサービスを提供する
./dank-mcp --sse-host 0.0.0.0:8080

🔧 技術詳細

プロジェクトアーキテクチャ

• データ取得層：指定されたインターフェースから公開データを取得する役割を担います。
• データ処理層：データのクリーニングと前処理を行います。
• 保存層：DuckDB を使用してデータを永続化します。
• サービス層：MCP 標準インターフェースを提供し、複数の伝送プロトコルをサポートします。

💻 使用例

基本的な使用法

# Dockerイメージをダウンロードして実行する（イメージを事前にビルドする必要があります）
docker build -t dank-mcp .
docker run -it --rm Dank-Mcp

高度な使用法

ユーザーは、設定パラメータを使用して動作をカスタマイズすることができます。たとえば、データ取得の API トークンを指定することができます。

# APIトークンを設定してサービスを起動する
./dank-mcp --token your_api_token_here

📚 ドキュメント

注意事項

• ログ記録：デフォルトでは、ログは標準エラー出力に出力されます。ユーザーは --log-file パラメータを使用してログファイルを指定することができます。
• データの一貫性：このプロジェクトが依存するデータソースには遅延や変更がある可能性があるため、定期的にデータを同期することをお勧めします。

プロジェクトの背景と展望

dank-mcp は、MCP 技術の特定分野での応用可能性を探索するための迅速な実験プロジェクトです。将来的には、以下の機能拡張を予定しています。

• より多くのデータソースをサポートする
• データクリーニングルールを強化する
• 多モーダルデータ処理能力（画像分析など）を提供する

貢献ガイド

コミュニティからのコードの貢献と問題のフィードバックを歓迎します。プロジェクトの CODE_OF_CONDUCT.md 規約に従い、良好な協力環境を維持してください。

📄 ライセンス

このプロジェクトは、Neomantra Corp. によって2025年にライセンスされ、MIT License のオープンソースライセンスの下で提供されています。詳細は LICENSE.txt を参照してください。

チーム紹介

dank-mcp は、AgentDank チームによって開発されたオープンソースプロジェクトです。私たちは、技術革新を通じてデータ分析分野の進歩を推進することに取り組んでおり、志を同じくする方々の参加を歓迎します！