sage-book-server 0.1.0

Sage Book Server Package

Jupyter MCP Server

A basic description of your Jupyter MCP Server package.

Installation

pip install .

Or using uv:

uv pip install .

Running the Server

1. Start Jupyter Lab:

jupyter lab --port 8888 --IdentityProvider.token MY_TOKEN --ip 0.0.0.0

2. In a separate terminal, start the MCP server:

python -m src.server.simple_server

3. Add the Anthropic model id and API key to the .env file.

Notes

• Replace MY_TOKEN with your desired authentication token
• The server will be accessible at http://localhost:8888
• Make sure to keep all three processes running (Jupyter Lab and both MCP server/client instances)

MCP Server Setup with uv

1. Install uv (if not already installed)

   curl -Ls https://astral.sh/uv/install.sh | bash
   

2. Navigate to the project directory

   cd /path/to/jupyter-mcp-server
   

3. Create a uv-managed virtual environment (Python 3.10)

   uv venv --python=3.10 .venv
   

4. Activate the environment

   source .venv/bin/activate
   

5. Install all required packages

   uv pip install -r requirements.txt
   

6. Run the MCP server

   uv --directory /path/to/jupyter-mcp-server run python -m src.server.simple_server --stdio