Trackor

🚀 Trackor

Trackorは、FastMCPとStreamlitを用いて構築されたカスタムMCP（Model Context Protocol）サーバーとダムクライアントです。このアプリケーションは、経費の追跡ツールを提供しており、経費の追加、一覧表示、集計、更新、データのエクスポートなどの機能があります。サーバーは、ローカルのSQLiteデータベース（expenses.db）とcategories.jsonファイルを使用して、経費のカテゴリを管理しています。

✨ 主な機能

ツールとリソース

TOOLS (操作を実行する呼び出し可能なアクション):
- add_expense                 : 新しい経費エントリを作成する
- get_expense                 : IDで単一の経費を取得する
- list_expenses               : オプションのフィルターで経費を一覧表示する
- update_expense              : 既存の経費を修正する
- delete_expense              : IDで1つの経費を削除する
- delete_expenses_by_date_range : 日付範囲内のすべての経費を削除する
- summarize                   : カテゴリ/サブカテゴリ別に経費を集計する
- get_statistics              : 全体の統計情報と月別の内訳を返す
- export_expenses             : すべての経費をJSONまたはCSV形式でエクスポートする

RESOURCES (サーバーによって公開される読み取り専用データ):
- expense://categories        : categories.jsonファイル（カテゴリ/サブカテゴリのリスト）を提供する

📦 インストール

ダムMCPクライアント

リモートデプロイ

このクライアントはすでにStreamlit Cloudを使ってhttps://dumbclient-trackor.streamlit.app/にデプロイされています。

ローカルデプロイ

streamlit run dumb_client/app.py

MCPサーバー

リモートデプロイ（最も簡単）

このサーバーはすでにFastMCP Cloudを使ってデプロイされています。あなたが必要なのは、このDXTファイルhttps://at0mxploit.fastmcp.app/manifest.dxtをClaude拡張機能にドラッグするだけです。これにより、Claudeにサーバーが自動的に設定され、すべてのツールとリソースが含まれます。（現在はPro版でのみ利用可能です）。この設定はすべての異なるモデルとツールに対応していますが、私はClaudeを使用しています。

ローカル開発

Claudeコネクタ（リモートMCP URL）はProユーザーのみ利用できます。ただし、Pro版ではないClaude Desktopユーザーでも、ローカルプロキシを実行することでこのMCPサーバーを使用できます。

このリポジトリには、シンプルなFastMCP STDIOブリッジが入ったproxy/フォルダが含まれています。

依存関係をインストールする:

uv sync

MCPを実行する:

uv run main.py

MCPプロキシを実行する:

uv run proxy/main.py

必要に応じて、Inspectorを使用してMCPのJSON RPC呼び出しをテストすることもできます:

uv run fastmcp dev .\main.py

Claude Desktopはもはや生のMCPスクリプトを自動的に読み込みません。
Pro版を使用していない場合は、同梱のデスクトップ拡張機能をインストールする必要があります:

npm install -g @anthropic-ai/mcpb

mcpb pack proxy/ trackor-proxy.mcpb

これによりtrackor-proxy.mcpbが生成されます。

1. 設定 → 拡張機能 → 詳細 → 拡張機能のインストール… へ移動します。
2. trackor-proxy.mcpbを選択します。
3. ClaudeはローカルのSTDIOプロキシを介してMCPサーバーを読み込みます。