Alexgoller MCP Server Agenda

🚀 mcp-server-agenda サーバー実装

Claude AIを通じてmacOS上のAgendaアプリケーションとやり取りするサーバー実装です。このサーバーは、ノートの作成、プロジェクトの管理、およびx-callback-urlを使用した既存ノートの開封機能を提供します。

✨ 主な機能

• 様々なオプション（タイトル、テキスト、日付、テンプレートなど）を持つAgendaノートの作成
• Agenda内のプロジェクトの作成と管理
• Claudeから直接既存のノートを開く
• Agendaのx-callback-urlスキームを完全にサポート

📦 インストール

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-server-agenda.git
   cd mcp-server-agenda
   

💻 使用例

基本的な使用法

X-Callback-URL 統合

このサーバーは、Agendaのx-callback-urlスキームを利用してアプリケーションとやり取りします。サポートされている操作は以下の通りです：

• create-note
• open-note
• create-project

Agendaのx-callback-urlスキームの詳細については、ドキュメントを参照してください。

高度な使用法

設定

Claude Desktop 設定

Claudeでこのサーバーとのやり取りを有効にするには、以下の設定をClaudeデスクトップの設定ファイル（$HOME/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
    "mcp-server-agenda": {
        "command": "uv",
        "args": [
            "--directory",
            "/Users/your.username/git/mcp-server-agenda",
            "run",
            "mcp-server-agenda"
        ]
    }
}

/Users/your.username を実際のユーザーディレクトリパスに置き換えてください。

プロジェクト要件

• macOSオペレーティングシステム
• Python 3.7以上のバージョン
• Agendaアプリケーションがインストールされていること
• uv - 最新のPythonパッケージインストーラーとパーサー

  pip install uv
  

• 必要なPythonライブラリ（requirements.txtを参照）

プロジェクト設定

このプロジェクトは pyproject.toml ファイルが必要です。ルートディレクトリに以下の内容のファイルを作成します：

[project]
name = "mcp-server-agenda"
version = "0.1.0"
description = "Claude AIを通じてmacOS上のAgendaアプリケーションとやり取りするサーバー実装"
requires-python = ">=3.7"
dependencies = [
    "flask",
    # ここに他の依存関係を追加
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

pyproject.toml ファイルを作成した後、以下のコマンドを使用して開発モードでプロジェクトをインストールできます：

uv pip install -e .

🤝 コントリビューションガイド

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'いくつかの素敵な機能を追加'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを開きます

📄 ライセンス

この作品はMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Agendaチームがx-callback-urlサポートを提供してくれたことに感謝します
• AIによるノート管理の必要性から着想を得ました

🆘 サポート

ヘルプが必要な場合は、GitHubリポジトリで問題を開くか、メンテナに連絡してください。