蓝调 Notehub MCP 服务器（Python）

这是一个使用官方 notehub_py SDK 与 Blues Notehub API 对接的模型上下文协议 (MCP) 服务端实现。它允许大型语言模型与其 Blues Notehub 项目、设备和数据进行交互。

什么是 MCP？

模型上下文协议 (MCP) 是一个开放协议，使 LLM 应用程序能够无缝集成到外部数据源和服务中。它标准化了 LLM 如何与外部工具和服务交互。

先决条件

• 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 服务器将启动并在控制台显示相关信息。

认证方式

该服务器支持 Notehub 的认证机制。您需要提供有效的 Notehub 账户凭据（电子邮件和密码）以进行身份验证。

连接到 MCP 客户端

要连接到 MCP 客户端（例如 Claude），请按照以下步骤操作：

1. 确保服务器已运行。
2. 在客户端中配置 MCP 服务端地址：

   export MCP_SERVER_URL=http://localhost:8000  # 根据实际端口调整
   

3. 启动客户端并与服务器建立连接。

可用工具

该服务器目前支持以下 Notehub API 功能：

• 获取项目信息
• 检索数据集
• 管理用户配置
• 执行基本查询

更多功能将逐步添加。

使用示例

示例 1：获取项目信息

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

示例 2：上传数据集

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

安全考虑

• 所有 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