ネクサスMCP

特徴

• Googleカレンダーとの統合

  • カレンダーイベントの作成、読み取り、更新、削除

  • 今後のイベントをリストする

• Obsidian Vault 管理

  • メモの作成、閲覧、更新、削除

  • ノートの全文検索

  • フォルダ管理（作成、削除、検索、一覧表示）

• Trelloとの統合

  • ボード、リスト、カードの管理

  • カードの作成、更新、削除

  • テキストクエリでカードを検索

• ウェブページの解析

  • 任意の URL から HTML コンテンツを抽出してクリーンアップします

• Googleニュース検索

  • 特定のトピックに関する最近のニュース記事を検索する

Telegramとブログに参加してください

Related MCP server: Daily Briefing MCP Server

前提条件

• Python 3.10以上

• Poetry（Python パッケージ マネージャー）

• Google カレンダー API 認証情報

• Trello API 認証情報 (Trello 機能を使用する場合)

• Obsidian Vault（Obsidian 機能を使用している場合）

インストール

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

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

2. Poetry を使用して依存関係をインストールします。

   poetry install

3. Google カレンダー API を設定します。

   • Google Cloud Consoleにアクセスします

   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください

   • GoogleカレンダーAPIを有効にする

   • OAuth 2.0認証情報を作成する

   • 資格情報をダウンロードし、プロジェクトルートにcredentials.jsonとして保存します。

4. Trello API を設定する (オプション):

   • Trello開発者ポータルへアクセス

   • APIキーとトークンを取得する

   • 環境変数または設定ファイルに追加します

構成

1. Google カレンダーで認証するには、初期設定を実行します。

   poetry run python main.py

   • Google認証用のブラウザウィンドウが開きます

   • 指示に従ってアプリケーションを承認します

使用法

1. サーバーを起動します。

   poetry run python main.py

2. サーバーが起動し、MCP 互換のクライアント接続を受け入れる準備が整います。

3. MCP互換クライアントを使用してサーバーとやり取りします。サーバーは以下のツールを提供します。

   • カレンダー管理

   • 黒曜石の金庫の操作

   • Trelloボード管理

   • ウェブページの解析

アントロピック・クロード・デスクトップ構成

このサーバーを Anthropic Claude Desktop で使用するには、Claude Desktop の設定に次の構成を追加します。

{
   "mcpServers": {
      "personal-assistant": {
         "command": "/path/to/your/venv/bin/python",
         "args": ["/path/to/your/project/main.py"],
         "env": {
                 "GOOGLE_CREDENTIALS_PATH": "/path/to/your/credentials.json",
                 "GOOGLE_TOKEN_PATH": "/path/to/your/token.json",
                 "GOOGLE_API_KEY": "your_google_api_key",
                 "GOOGLE_CX_ID": "your_google_cx_id",
                 "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
                 "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder",
                 "TRELLO_API_KEY": "your_trello_api_key",
                 "TRELLO_TOKEN": "your_trello_token",
                 "LOG_PATH": "/path/to/log.txt",
                 "ENABLE_OBSIDIAN_TOOLS": "True/False",
                 "ENABLE_TRELLO_TOOLS": "True/False",
                 "ENABLE_CALENDAR_TOOLS": "True/False",
                 "ENABLE_NEWS_SEARCH": "True/False",
                 "ENABLE_WEB_PARSER": "True/False",
                 "SEMANTIC_SEARCH_ENABLED": "True/False",
                 "EMBEDDINGS_PATH": "/path/to/embeddings.json"
         }
      }
   }
}

パスと資格情報を実際の値に置き換えます。

• command : Python仮想環境のPython実行ファイルへのパス

• args : プロジェクトのmain.pyファイルへのパス

• ENABLE_OBSIDIAN_TOOLS : Obsidianツールを有効にするにはTrueに設定します

• ENABLE_TRELLO_TOOLS : Trelloツールを有効にするにはTrueに設定します

• ENABLE_CALENDAR_TOOLS : Google カレンダー ツールを有効にするにはTrueに設定します

• ENABLE_NEWS_SEARCH : Google ニュース検索を有効にするにはTrueに設定します

• ENABLE_WEB_PARSER : Webパーサーツールを有効にするにはTrueに設定します

• GOOGLE_CREDENTIALS_PATH : Google カレンダーの認証情報ファイルへのパス ( credentials.json )

• GOOGLE_TOKEN_PATH : Google カレンダー トークン ファイルへのパス ( token.json )

• GOOGLE_API_KEY : Google API キー（カスタム検索 API 用）

• GOOGLE_CX_ID : Google プログラマブル検索エンジン ID (カスタム検索 API の CX ID)

• OBSIDIAN_VAULT_PATH : Obsidian Vault へのパス

• OBSIDIAN_DEFAULT_FOLDER : 新しいノートを作成するボールト内のデフォルトフォルダへのオプションのパス

• TRELLO_API_KEY : Trello APIキー

• TRELLO_TOKEN : Trello APIトークン

• LOG_PATH : ログファイルへのパス

• SEMANTIC_SEARCH_ENABLED : Obsidian Vault のセマンティック検索を有効にするにはTrueに設定します

• EMBEDDINGS_PATH : Obsidian Vector Search プラグインによって生成された埋め込み json ファイルへのオプションのパス (設定されていない場合は、 OBSIDIAN_VAULT_PATHを基準とした.obsidian/plugins/vector-search/data.jsonがデフォルトになります)

セマンティック検索機能を有効にするには、Obsidian のVector Search プラグインをインストールする必要があります。

再インデックス処理が完了すると、プラグインは次の場所にベクター埋め込みを含む JSON ファイルを生成します。

.obsidian/plugins/vector-search/data.json

このファイルは、セマンティック検索クエリの埋め込みソースとして使用されます。

推奨クライアント:

• アントロピック・クロード・デスクトップ

• 5ire

発達

• このプロジェクトは依存関係の管理にPoetryを使用しています

• すべてのツールはmain.pyに登録されています

• サービス固有の実装はservices/ディレクトリにあります

• PythonコードのPEP 8スタイルガイドラインに従う

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く