Ainote MCP

🚀 AI Note MCP Server

AI Note MCP Serverは、Claude DesktopをAI Noteタスク管理システムに接続するModel Context Protocol (MCP)サーバーです。このサーバーにより、ClaudeはAI Noteのタスクと直接やり取りでき、自然言語会話を通じてタスクの作成、更新、管理が可能になります。

🚀 クイックスタート

AI Note MCP Serverを使用することで、Claude Desktopから直接AI Noteのタスクを管理できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• 📝 タスク管理：Claude Desktopから直接タスクの作成、更新、削除、一覧表示ができます。
• 🏷️ カテゴリサポート：カテゴリを使用してタスクを整理できます。
• 🔍 高度な検索：タスクの内容、状態などでタスクを検索できます。
• ⭐ 優先度管理：タスクを重要としてマークできます。
• 📅 期限サポート：タスクの期限を設定し、管理できます。
• 🔒 安全なAPI統合：APIキー認証を使用して安全にアクセスできます。

📦 インストール

オプション1：npmからインストール

npm install -g @ainote/mcp

オプション2：ソースからインストール

git clone https://github.com/ainote-dev/ainote-mcp.git
cd ainote-mcp-server
npm install

更新

npmからの更新（推奨）

npmを介してインストールした場合、最新バージョンに更新するには：

npm update -g @ainote/mcp

または、特定のバージョンをインストールするには：

npm install -g @ainote/mcp@1.0.2

ソースからの更新

ソースからインストールした場合：

cd ainote-mcp-server
git pull origin main
npm install

更新後、Claude Desktopを再起動して新しいバージョンを読み込んでください。

🔧 設定

MCPサーバーをClaude Desktopに接続するには、以下の手順に従ってください。

手順1：AI Note APIキーを取得

ClaudeがAI Noteのタスクにアクセスできるようにするには、AI NoteアカウントからAPIキーが必要です。APIキーはAI Noteアプリの設定画面で見つけるか、生成できます。

手順2：Claude Desktopを設定

ainote-mcpサーバーをClaude Desktopの設定ファイルに追加します。このファイルは以下の場所にあります。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

ファイルを開き、mcpServersオブジェクト内に以下のJSONブロックを追加します。your-api-key-hereを実際のAI Note APIキーに置き換えてください。

{
  "mcpServers": {
    "ainote": {
      "command": "ainote-mcp",
      "env": {
        "AINOTE_API_KEY": "your-api-key-here"
      }
    }
  }
}

注：セルフホストまたは別のAI Noteサーバーに接続する場合は、AINOTE_API_URL環境変数も追加できます。

"env": {
  "AINOTE_API_KEY": "your-api-key-here",
  "AINOTE_API_URL": "https://your-custom-api-url.com"
}

手順3：Claude Desktopを再起動

設定ファイルを保存した後、Claude Desktopを完全に再起動します。新しいMCPサーバーが読み込まれ、Claudeを通じてAI Noteのタスクを管理できるようになります。

💻 使用例

基本的な使用法

設定が完了すると、Claudeを通じてAI Noteのタスクとやり取りできます。

会話例

You: "Show me my pending tasks"
Claude: I'll retrieve your pending tasks from AI Note...

You: "Create a new task to review the quarterly report by Friday"
Claude: I'll create that task for you with a due date set for Friday...

You: "Mark task ID 123 as completed"
Claude: I'll mark that task as completed...

高度な使用法

利用可能なツール

list_tasks

AI Noteからフィルタリングオプションを使用してタスクを一覧表示します。

パラメーター:

• status (オプション): 状態でフィルタリング - "pending" または "completed"
• limit (オプション): 最大タスク数 (デフォルト: 25, 最大: 500)
• search (オプション): タスク内容の検索キーワード

create_task

AI Noteに新しいタスクを作成します。

パラメーター:

• content (必須): タスクの説明
• is_important (オプション): 重要としてマーク (ブール値)
• due_date (オプション): ISO形式の期限
• category_id (オプション): 割り当てるカテゴリID

update_task

既存のタスクを更新します。

パラメーター:

• id (必須): タスクID
• content (オプション): 新しいタスク内容
• is_important (オプション): 重要ステータスを更新
• completed_at (オプション): 完了としてマーク (ISO形式) または未完了にする場合はnull

delete_task

タスクをソフトデリートします。

パラメーター:

• id (必須): 削除するタスクID

list_categories

すべての利用可能なカテゴリを一覧表示します。

パラメーター: なし

📚 ドキュメント

APIリファレンス

MCPサーバーは以下のエンドポイントを使用してAI Note APIと通信します。

• GET /api/mcp/tasks - タスクを一覧表示
• POST /api/mcp/tasks - タスクを作成
• PUT /api/mcp/tasks/:id - タスクを更新
• DELETE /api/mcp/tasks/:id - タスクを削除
• GET /api/mcp/categories - カテゴリを一覧表示

すべてのリクエストは、APIキーを使用したAuthorizationヘッダーで認証が必要です。

開発

ローカルでの実行

# リポジトリをクローン
git clone https://github.com/ainote-dev/ainote-mcp.git
cd ainote-mcp-server

# 依存関係をインストール
npm install

# サーバーを実行
npm start

Claude Desktopでのテスト

1. Claude Desktopの設定を更新して、ローカル開発サーバーを指すようにします。
2. テスト用の環境変数を設定します。
3. Claude Desktopを再起動します。
4. Claude Desktopの設定でMCP接続ステータスを確認します。

プロジェクト構造

ainote-mcp-server/
├── index.js          # メインサーバー実装
├── package.json      # パッケージ構成
├── README.md         # 英語のドキュメント
├── README-ko.md      # 韓国語のドキュメント
└── LICENSE           # MITライセンス

トラブルシューティング

一般的な問題

1. "API key not found"エラー

   • AINOTE_API_KEYが環境またはClaudeの設定に設定されていることを確認してください。
   • APIキーが有効で、適切な権限があることを確認してください。

2. "Connection refused"エラー

   • API URLが正しいことを確認してください。
   • ネットワーク接続を確認してください。
   • AI Note APIサーバーが実行中であることを確認してください。

3. "Tool not found"エラー

   • 設定変更後にClaude Desktopを再起動してください。
   • MCPサーバーがClaude Desktopに正しく設定されていることを確認してください。

4. タスクが表示されない

   • APIキーの権限を確認してください。
   • 正しい状態（保留/完了）をクエリしていることを確認してください。
   • 検索パラメーターを使用してみてください。

デバッグモード

デバッグログを有効にするには：

export DEBUG=mcp:*

貢献

貢献を歓迎します！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを開きます。

開発ガイドライン

• 既存のコードスタイルに従ってください。
• 新しい機能に対してテストを追加してください。
• 必要に応じてドキュメントを更新してください。
• PRを提出する前にすべてのテストが通過することを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

サポート

• 📧 メール: support@ainote.dev
• 🐛 問題: GitHub Issues
• 💬 Discord: コミュニティに参加

謝辞

• Model Context Protocol SDKで構築されています。
• AI Noteによって提供されています。
• Claude Desktop用に作成されています。