MCP.so
ログイン

Blues Notehub MCP Server (Python)

@blues

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

作者

blues

Blues Notehub MCP Server について

MCP Server Implementation of the Blues Notehub API

Blues Notehub MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "notehub_mcp_server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Blues Notehub MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Blues Notehub MCP Server (Python)?

Blues Notehub MCP Server (Python) is a Model Context Protocol (MCP) server that uses the official notehub_py SDK to interact with the Blues Notehub API. It enables large language models to access and manage Blues Notehub projects, devices, and data.

How to use Blues Notehub MCP Server (Python)?

Install dependencies with pip or uv, then run python notehub.py. Provide your Notehub username (email) and password to the tools when prompted. The server uses X-Session-Token authentication and automatically caches the token for 29 minutes. Connect it to an MCP client like Claude for Desktop by configuring the client’s JSON config file with the command to run the server.

Key features of Blues Notehub MCP Server (Python)

  • Lists all accessible Notehub projects (get-projects)
  • Fetches devices for a project with optional filtering (get-project-devices)
  • Retrieves events for a project with optional filtering (get-project-events)
  • Sends a note to a specific device (send-note)
  • Automatic token caching and refresh every 29 minutes

Use cases of Blues Notehub MCP Server (Python)

  • List all Notehub projects under an account
  • Fetch and filter devices belonging to a specific project
  • Retrieve recent events from a project or device
  • Send custom notes or commands to a device
  • Integrate Notehub data into an LLM agent workflow

よくある質問

1

What are the prerequisites?

Python 3.8 or higher, a Blues Notehub account, and your Notehub username (email) and password.

2

How does authentication work?

The server uses the `/auth/login` endpoint to obtain an X-Session-Token, caching it for 29 minutes and automatically refreshing it when needed. Tokens expire after 30 minutes.

3

Where are logs stored if issues occur?

On macOS: `~/Library/Logs/Claude/mcp-server-notehub.log`. On Windows: `%APPDATA%\Claude\Logs\mcp-server-notehub.log`.

4

What transport does the server use?

It runs using stdio as the transport layer, the standard transport for most MCP clients.

5

How do I use it with Claude for Desktop?

Edit the Claude Desktop configuration file (`claude_desktop_config.json`) to include a `notehub` entry pointing to the server script (e.g., `python notehub.py`). Restart Claude for Desktop.

コメント

「その他」の他のコンテンツ