Nexus MCP

🚀 Nexus MCP

Nexus MCPは、Googleカレンダー、Obsidian Vault、Trelloなどの様々なサービスと統合された強力な個人用アシスタントMCPサーバーです。ウェブページの解析機能も備えており、FastMCPを使用して構築されています。このサーバーは、デジタルライフを管理するための統一インターフェースを提供します。

🚀 クイックスタート

このセクションでは、Nexus MCPサーバーのセットアップと使用方法を説明します。

前提条件

• 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 Developer Portalにアクセスします。
   • APIキーとトークンを取得します。
   • 環境変数または設定ファイルに追加します。

設定

1. Googleカレンダーで認証するために初期セットアップを実行します。

poetry run python main.py

これにより、Google認証のためのブラウザウィンドウが開きます。指示に従ってアプリケーションを承認します。

使用方法

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

poetry run python main.py

2. サーバーが起動し、MCP互換クライアントの接続を受け入れる準備ができます。
3. 任意のMCP互換クライアントを使用してサーバーとやり取りします。サーバーは以下のツールを提供します。
   • カレンダー管理
   • Obsidianボルト操作
   • Trelloボード管理
   • ウェブページ解析

Anthropic Claude Desktopの設定

このサーバーを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：ウェブページ解析ツールを有効にするには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ボルトのパス
• OBSIDIAN_DEFAULT_FOLDER：新しいノートが作成されるボルト内のデフォルトフォルダのオプションパス
• TRELLO_API_KEY：Trello APIキー
• TRELLO_TOKEN：Trello APIトークン
• LOG_PATH：ログファイルのパス
• SEMANTIC_SEARCH_ENABLED：Obsidianボルトの意味検索を有効にするにはTrueに設定
• SIMILARITY_TRESHOLD：デフォルト値は0.5で、これは意味検索の閾値です
• EMBEDDINGS_PATH：Obsidian Vector Searchプラグインによって生成される埋め込みJSONファイルのオプションパス（設定されていない場合は、OBSIDIAN_VAULT_PATHを基準として.obsidian/plugins/vector-search/data.jsonにデフォルト設定されます）
• MODEL_TOKEN_LIMIT：AIモデルがノートを分割するタイミングを理解するための制限
• CHUNK_SIZE_TOKENS：チャンクサイズ

意味検索機能を有効にするには、Obsidian用のVector Searchプラグインをインストールする必要があります。

再インデックス作成プロセスが完了すると、プラグインは以下の場所にベクトル埋め込みを含むJSONファイルを生成します。 .obsidian/plugins/vector-search/data.json このファイルは、意味検索クエリの埋め込みソースとして使用されます。

✨ 主な機能

• Googleカレンダー統合
  • カレンダーイベントの作成、読み取り、更新、削除
  • 今後のイベントの一覧表示
• Obsidian Vault管理
  • ノートの作成、読み取り、更新、削除
  • ノートの全文検索
  • フォルダ管理（作成、削除、検索、一覧表示）
• Trello統合
  • ボード、リスト、カードの管理
  • カードの作成、更新、削除
  • テキストクエリでカードを検索
• ウェブページ解析
  • 任意のURLからHTMLコンテンツを抽出してクリーンアップ
• Googleニュース検索
  • 特定のトピックに関する最近のニュース記事を検索

推奨クライアント

• Anthropic Claude Desktop
• 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. プルリクエストを開きます。

Telegramとブログで一緒になりましょう。