nteract

library2.3.1pypypi✓ verified 79d ago

nteract provides an MCP (Model Context Protocol) server that brings AI agents into Jupyter notebooks. It allows LLMs like Claude, ChatGPT, Gemini, and OpenCode to execute code, read outputs, and interact with notebook environments. Version 2.3.1 requires Python >=3.10. Release cadence is irregular, with recent updates focused on MCP protocol support.

ai-ml llm-agents data

pip install nteract

package ↗homepage ↗

INSTALL

IMPORT

SIG · NTERACT

nteract

ai-mlpythonv2.3.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

main

✓ from nteract import main

✗ import nteract.mcp_server

Start the nteract MCP server for AI agent integration. Requires an API key (e.g., Anthropic) set in environment.

import os from nteract.mcp_server import run_server # Ensure API key is set in environment api_key = os.environ.get('ANTHROPIC_API_KEY', '') if not api_key: print("Please set ANTHROPIC_API_KEY environment variable") else: run_server()

nteract --version

Debug

Known issues

breakingnteract v2.x drops support for Python <3.10. Upgrade your Python environment.

fix

Ensure Python >=3.10 is installed before upgrading.

affects: >=2.0.0

deprecatedThe old nteract 'kernel' and 'comm' modules (from v1.x) are removed. Use nteract.mcp_server for AI integration.

fix

Replace imports like 'from nteract.kernel import ...' with 'from nteract.mcp_server import ...'.

affects: >=2.0.0

gotchaThe MCP server requires environment variables for API keys (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY). Failing to set them causes silent hangs.

fix

Set the required API key before calling run_server().

affects: all

gotchaBy default, the server binds to localhost:8000. If that port is in use, the startup will fail with an address-in-use error.

fix

Pass a custom port via the MCP_PORT environment variable or modify the server configuration.

affects: all

Upgrade

Version history

2.3.1latest on PyPI · released Apr 25, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

21 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

packagehttps://pypi.org/project/nteract/ ↗

homepagehttps://nteract.io ↗