Notehub MCP Server

🚀 ブルース Notehub MCP サーバー（Python）

このサーバーは、公式の notehub_py SDK を使用して、Blues Notehub API と接続するモデルコンテキストプロトコル (MCP) のサーバーサイド実装です。大規模言語モデルが、Blues Notehub のプロジェクト、デバイス、およびデータと相互作用できるようにします。

🚀 クイックスタート

このサーバーを使用することで、大規模言語モデルが Blues Notehub のプロジェクト、デバイス、データと相互作用できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 大規模言語モデルと Blues Notehub の連携を可能にする。
• Notehub API の機能を使用して、プロジェクト情報の取得、データセットの検索、ユーザー設定の管理、基本的なクエリの実行ができる。

📦 インストール

前提条件

• Python 3.8 以上
• Blues Notehub アカウント（https://notehub.io）
• Notehub アカウントのユーザー名（メールアドレス）とパスワード

方法 1：pip を使用する（推奨）

1. このリポジトリをクローンまたはダウンロードします。
2. 仮想環境を作成します。

python -m venv venv
source venv/bin/activate  # Windows の場合は：venv\Scripts\activate

3. 依存関係をインストールします。

pip install -r requirements.txt

方法 2：uv を使用する（高速な代替手段）

1. https://github.com/astral-sh/uv の説明に従って uv をインストールします。
2. 環境を作成し、依存関係をインストールします。

uv venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate
uv pip install -r requirements.txt

💻 使用例

基本的な使用法

サーバーの起動

python notehub.py

MCP サーバーが起動し、コンソールに関連情報が表示されます。

サンプル 1：プロジェクト情報の取得

curl http://localhost:8000/api/projects

サンプル 2：データセットのアップロード

curl -X POST -F "file=@example.csv" http://localhost:8000/api/datasets

高度な使用法

MCP クライアントへの接続

1. サーバーが実行されていることを確認します。
2. クライアントで MCP サーバーのアドレスを設定します。

export MCP_SERVER_URL=http://localhost:8000  # 実際のポートに合わせて調整してください

3. クライアントを起動し、サーバーとの接続を確立します。

📚 ドキュメント

認証方式

このサーバーは Notehub の認証メカニズムをサポートしています。認証を行うには、有効な Notehub アカウントの資格情報（メールアドレスとパスワード）を提供する必要があります。

利用可能なツール

このサーバーは現在、以下の Notehub API 機能をサポートしています。

• プロジェクト情報の取得
• データセットの検索
• ユーザー設定の管理
• 基本的なクエリの実行

今後、さらに多くの機能が追加されます。

セキュリティに関する考慮事項

• すべての API リクエストは HTTPS で暗号化されています。
• ユーザーの資格情報はサーバー側の安全なデータベースに保存されています。
• GitHub ログインでアカウントを作成した場合は、Notehub アカウント設定でパスワードを設定してください。

トラブルシューティング

問題が発生した場合は、以下の手順を試してください。

1. ログファイルのエラーメッセージを確認します。
   • macOS：~/Library/Logs/Claude/mcp-server-notehub.log
   • Windows：%APPDATA%\Claude\Logs\mcp-server-notehub.log
2. Notehub の資格情報が正しいことを確認します。
3. GitHub ログインを使用している場合は、Notehub アカウント設定でパスワードを設定していることを確認します。

サーバーの拡張

このサーバーにさらに多くの機能を追加するには、以下の手順を行います。

1. Notehub API の他の機能を拡張します。
2. @mcp.tool() デコレータを使用して新しいツールを登録します。
3. 既存のツールにさらに多くのフィルターオプションを追加します。
4. 追加のエラー処理とレポートを実装します。

📄 ライセンス

MIT