Obsidian Tasks MCP

🚀 Obsidian タスク MCP サーバ

このサーバは、Markdown ファイルから Obsidian タスクを抽出し、クエリを実行するための Model Context Protocol (MCP) サーバです。Claude と連携し、MCP プロトコルを通じて機能を実現するように設計されています。

🚀 クイックスタート

Obsidian タスク MCP サーバを使用することで、Markdown ファイルからタスク情報を抽出し、クエリを実行できます。以下に基本的な使用方法を示します。

インストール

npm install -g @jfim/obsidian-tasks-mcp

タスクの抽出

obsidian-tasks /path/to/obsidian-vault

タスクのクエリ

query --tag work --priority high /path/to/output.json

✨ 主な機能

• タスク抽出：複数の形式のタスク項目を識別して解析することができます。
• 時間情報の処理：期限日、予定日などの時間情報を処理します。
• 優先度の識別：高、中、低の優先度マークを識別します。
• 繰り返しタスクの解析：定期的な繰り返しタスクを解析します。
• タグのサポート：関連するタグを抽出して管理します。

📦 インストール

npm を使用したインストール

npm install -g @jfim/obsidian-tasks-mcp

ソースコードからのビルド

git clone https://github.com/jfim/obsidian-tasks-mcp.git
cd obsidian-tasks-mcp
npm install
npm run build

💻 使用例

1. 抽出ツール (obsidian-tasks)

基本的な使用法

obsidian-tasks /path/to/obsidian-vault

サポートされるオプション

• --recursive：すべてのサブディレクトリを再帰的に走査します。
• --filter：特定のタグや日付範囲などのフィルタ条件を指定します。
• --output-format：出力形式を設定します（JSON、CSV などをサポート）。

出力例

[
  {
    "id": "1",
    "description": "完成项目报告",
    "due-date": "2025-05-01",
    "tags": ["work", "report"],
    "priority": "high"
  },
  {
    "id": "2",
    "description": "回顾会议纪要",
    "scheduled-date": "2025-04-30",
    "start-date": "2025-04-28",
    "recurrence": "每周一次"
  }
]

2. クエリツール (query)

サポートされるクエリ条件

• タグ：#tag
• 時間範囲：due:YYYY-MM-DD..YYYY-MM-DD
• 優先度：priority:high/medium/low

例

query --tag work --priority high /path/to/output.json

3. 分析ツール (analyze)

サポートされる分析タイプ

• 時間分布：日付ごとにタスク数を集計します。
• タグ頻度：各タグの出現回数を分析します。
• 優先度分布：異なる優先度のタスクの割合を集計します。

例

analyze /path/to/output.json --output report.html

🐳 Docker の使用

イメージのビルド

docker build -t @jfim/obsidian-tasks-mcp .

コンテナの実行

docker run -i --rm --mount type=bind,src=/path/to/vault,dst=/projects/vault @jfim/obsidian-tasks-mcp /projects

Claude Desktop の設定例

{
  "mcpServers": {
    "obsidian-tasks": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/path/to/vault,dst=/projects/vault",
        "@jfim/obsidian-tasks-mcp",
        "/projects"
      ]
    }
  }
}

📋 タスク形式

以下の Obsidian タスク形式をサポートしています。

• 基本形式：- [ ] タスクの説明
• 完了済みタスク：- [x] タスクの説明
• 期限日：🗓️ YYYY-MM-DD
• 予定日：⏳ YYYY-MM-DD
• 開始日：🛫 YYYY-MM-DD
• 作成日：➕ YYYY-MM-DD
• 優先度：⏫ (高), 🔼 (中), 🔽 (低)
• 繰り返しタスク：🔁 every day/week/month/etc.
• タグ：#tag1 #tag2

例：

- [ ] 完成项目报告 🗓️ 2025-05-01 ⏳ 2025-04-30 🔼

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

🤝 貢献ガイド

このツールを共同で改善するために、fork して PR を送信することを歓迎します。

📞 連絡先

フィードバックや議論がある場合は、以下の方法で連絡してください。

• メール：contact@jfim.com
• GitHub：https://github.com/jfim/obsidian-tasks-mcp

⚠️ 重要注意

このプロジェクトはまだ開発段階であり、一部の機能が未完成の場合があります。使用する前にドキュメントをよく読み、重要なデータをバックアップしてください。