Notehub MCP Server

🚀 藍調 Notehub MCP 服務器（Python）

這是一個藉助官方 notehub_py SDK 與 Blues Notehub API 對接的模型上下文協議 (MCP) 服務端實現。它能讓大型語言模型與 Blues Notehub 項目、設備和數據進行交互，為相關應用提供了強大支持。

🚀 快速開始

本服務器允許大型語言模型與 Blues Notehub 項目、設備和數據進行交互。要使用該服務器，您需要完成安裝、運行服務器、認證、連接客戶端等步驟。

✨ 主要特性

• 開放協議支持：基於模型上下文協議 (MCP)，使 LLM 應用程序能無縫集成到外部數據源和服務中。
• Notehub API 功能豐富：支持獲取項目信息、檢索數據集、管理用戶配置、執行基本查詢等功能，且會逐步添加更多功能。
• 安全可靠：所有 API 請求使用 HTTPS 加密，用戶憑據存儲在服務器端的安全數據庫中。

📦 安裝指南

先決條件

• 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 服務器將啟動並在控制檯顯示相關信息。

連接到 MCP 客戶端

要連接到 MCP 客戶端（例如 Claude），請按照以下步驟操作：

1. 確保服務器已運行。
2. 在客戶端中配置 MCP 服務端地址：

   export MCP_SERVER_URL=http://localhost:8000  # 根據實際端口調整
   

3. 啟動客戶端並與服務器建立連接。

高級用法

示例 1：獲取項目信息

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

示例 2：上傳數據集

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

📚 詳細文檔

認證方式

該服務器支持 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 許可證。