Personal Assistant MCP

🚀 ニューロン MCP サーバー

これは強力な多機能個人用アシスタントサーバーで、Google Calendar、Obsidian Vault、Trello などの複数のサービスやウェブページ解析機能を統合しています。

🚀 クイックスタート

ニューロン MCP サーバーは、多くの便利な機能を備えた個人用アシスタントサーバーです。以下の手順に従って、サーバーをセットアップして使用を開始できます。

✨ 主な機能

統合サービス

• Googleカレンダー：カレンダーイベントの管理と同期を行います。
• Obsidianボールト：セマンティック検索機能を提供し、ベクトル検索もサポートします（Vector Search プラグインのインストールが必要）。
• Trello：カンバンタスクの処理とプロジェクト管理を行います。
• ウェブページ解析器：指定されたURLからウェブページの内容を抽出して解析します。

核心特性

• モジュール化設計：各サービスは独立して動作し、保守と拡張が容易です。
• セマンティック検索：コンテキスト理解に基づいたインテリジェントなクエリを行います。
• ログ記録：操作ログを記録し、問題のトラブルシューティングに役立てます。

📦 インストール

前提条件

• オペレーティングシステム：Linux または macOS システムが推奨されます。Windows 環境では追加の設定が必要になる場合があります。
• Python バージョン：Python 3.8 またはそれ以上のバージョンをインストールする必要があります。
• 依存関係管理ツール：パッケージ管理に Poetry をインストールしてください。

インストール手順

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

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

2. 依存関係をインストールします：

   poetry install
   

3. 環境変数を設定します：

   • .env ファイルを作成して編集し、対応する API 資格情報とパス情報を記入してください。

4. サービスを起動します：

   poetry run start
   

📚 ドキュメント

環境変数設定例（Anthropic Claude Desktop 用）

# サンプル .env ファイル内容
GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json
GOOGLE_TOKEN_PATH=/path/to/token.json
GOOGLE_API_KEY=your_api_key_here
GOOGLE_CX_ID=your_cx_id_here

OBSIDIAN_VAULT_PATH=/path/to/obsidian vault
OBSIDIAN_DEFAULT_FOLDER=/path/to/default folder
TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token
LOG_PATH=/path/to/logfile.log
SEMANTIC_SEARCH_ENABLED=True
SIMILARITY_THRESHOLD=0.5
EMBEDDINGS_PATH=/path/to/embeddings.json
MODEL_TOKEN_LIMIT=4096
CHUNK_SIZE_TOKENS=1024

ベクトル検索プラグイン

セマンティック検索機能を有効にするには、Obsidian で Vector Search プラグイン をインストールして設定する必要があります。プラグインの設定が完了すると、.obsidian/plugins/vector-search/data.json に埋め込みファイルが生成されます。

推奨クライアント

• Anthropic Claude Desktop
• 5ire

開発ガイド

プロジェクト構造

• poetry：依存関係管理に使用されます。
• main.py：すべてのツールとサービスを登録するメインエントリポイントです。
• services/：各サービスの具体的な実装モジュールです。

貢献の流れ

1. コードリポジトリをフォークします。
2. 機能ブランチを作成します：

   git checkout -b feature/your-feature-name
   

3. 変更をコミットしてリモートリポジトリにプッシュします：

   git commit -m '機能の追加または改善'
   git push origin feature/your-feature-name
   

4. Pull Request を送信します。

画像例