Notehub MCP Server

🚀 Blues Notehub MCP Server (Python)

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

🚀 Quick Start

What is MCP?

The Model Context Protocol (MCP) is an open protocol that allows LLM applications to seamlessly integrate with external data sources and services. It standardizes how LLMs interact with external tools and services.

Prerequisites

• Python 3.8 or higher
• A Blues Notehub account (https://notehub.io)
• Your Notehub account username (email) and password

Installation

Method 1: Using pip (Recommended)

1. Clone or download this repository.
2. Create a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

Method 2: Using uv (Faster alternative)

1. Install uv according to the instructions at https://github.com/astral-sh/uv.
2. Create an environment and install dependencies:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   uv pip install -r requirements.txt
   

Running the Server

Run the server using the following command:

python notehub.py

The MCP server will start and display relevant information in the console.

Authentication Method

This server supports Notehub's authentication mechanism. You need to provide valid Notehub account credentials (email and password) for authentication.

Connecting to the MCP Client

To connect to an MCP client (e.g., Claude), follow these steps:

1. Ensure the server is running.
2. Configure the MCP server address in the client:

   export MCP_SERVER_URL=http://localhost:8000  # Adjust according to the actual port
   

3. Start the client and establish a connection with the server.

✨ Features

The server currently supports the following Notehub API features:

• Get project information
• Retrieve datasets
• Manage user configurations
• Execute basic queries

More features will be added gradually.

💻 Usage Examples

Basic Usage

Example 1: Get project information

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

Example 2: Upload a dataset

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

🔧 Technical Details

Security Considerations

• All API requests are encrypted using HTTPS.
• User credentials are stored in a secure database on the server side.
• If you created your account using GitHub login, make sure to set a password in your Notehub account settings.

Troubleshooting

If you encounter issues:

1. Check the error information in the log file:
   • macOS: ~/Library/Logs/Claude/mcp-server-notehub.log
   • Windows: %APPDATA%\Claude\Logs\mcp-server-notehub.log
2. Confirm that your Notehub credentials are correct.
3. If you used GitHub login, make sure to set a password in your Notehub account settings.

Extending the Server

To add more features to the server:

1. Extend other functions of the Notehub API.
2. Register new tools using the @mcp.tool() decorator.
3. Add more filtering options for existing tools.
4. Implement additional error handling and reporting.

📄 License

MIT