North MCP Python SDK
An sdk for creating MCP Servers with north
What is North MCP Python SDK?
North MCP Python SDK is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to sdk for creating mcp servers with north
An sdk for creating MCP Servers with north
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An sdk for creating MCP Servers with north
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx north-mcp-python-sdkConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use North MCP Python SDK
The North MCP Python SDK is a framework from Cohere AI for building production-ready MCP servers that use the StreamableHTTP transport. It extends the standard MCP Python SDK with built-in user authentication, OAuth token access, a health check endpoint, and OpenTelemetry tracing — making it straightforward to build secure, multi-user MCP services where each connected user has their own identity and third-party API tokens available. Developers building shared or hosted MCP services on the North platform will find it handles the infrastructure plumbing that the vanilla SDK leaves to the developer.
Prerequisites
- Python 3.10 or later and the uv package manager
- Git and SSH access to the Cohere AI GitHub organization (for installation)
- The North platform or a compatible StreamableHTTP MCP client
- Optional: An OpenTelemetry backend endpoint if tracing is desired
Install the North MCP Python SDK
Install directly from the GitHub repository using uv pip. The package is not published to PyPI.
uv pip install git+ssh://[email protected]/cohere-ai/north-mcp-python-sdk.gitCreate a basic North MCP server
Import NorthMCPServer and create a server instance with a name, port, and optional shared secret for request authentication.
from north_mcp import NorthMCPServer, get_authenticated_user
mcp = NorthMCPServer(
name="My North Server",
port=5222,
server_secret="your_shared_secret"
)
@mcp.tool()
def greet_user() -> str:
user = get_authenticated_user()
return f"Hello, {user.email}!"
if __name__ == "__main__":
mcp.run()Access OAuth tokens for third-party services
The SDK makes OAuth connector tokens available per authenticated user, so each user's requests use their own credentials for external API calls.
from north_mcp import get_authenticated_user
@mcp.tool()
def call_external_api() -> str:
user = get_authenticated_user()
token = user.connector_access_tokens.get("github")
# Use token to make authenticated GitHub API calls
return f"Token obtained for {user.email}"Configure OpenTelemetry tracing (optional)
Enable distributed tracing by setting standard OpenTelemetry environment variables before starting the server.
export OTEL_EXPORTER_OTLP_ENDPOINT="https://your-otel-backend:4318"
export OTEL_SERVICE_NAME="my-north-server"
export DEBUG=true # Enable detailed authentication loggingRun the server
Start your North MCP server. It will listen on the configured port using the StreamableHTTP transport.
python server.pyNorth MCP Python SDK Examples
Client configuration
MCP client configuration for connecting to a North MCP server running locally over StreamableHTTP.
{
"mcpServers": {
"north-server": {
"type": "url",
"url": "http://localhost:5222/mcp"
}
}
}Prompts to try
Prompts to verify the North MCP server is running and user identity is accessible.
- "Who am I? Show me the authenticated user identity from the North server"
- "Call the greet_user tool and tell me the response"
- "What tools does this North MCP server expose?"
- "Check the health of the North MCP server"Troubleshooting North MCP Python SDK
Installation fails with SSH permission denied
The SDK installs via SSH from a private GitHub repository. Ensure your SSH key is added to GitHub and you have access to the cohere-ai organization. Run ssh -T [email protected] to verify SSH authentication.
Authentication failures when connecting clients to the server
Set DEBUG=true before starting the server to log detailed authentication flow information. Ensure the server_secret in the server matches what the client is sending. Check that your MCP client supports the StreamableHTTP transport.
get_authenticated_user() raises an error inside a tool
This function is only valid within the context of an active request. Ensure it is called inside a tool function decorated with @mcp.tool(), not at module initialization time. The user context is per-request and not globally available.
Frequently Asked Questions about North MCP Python SDK
What is North MCP Python SDK?
North MCP Python SDK is a Model Context Protocol (MCP) server that sdk for creating mcp servers with north It connects AI assistants to external tools and data sources through a standardized interface.
How do I install North MCP Python SDK?
Follow the installation instructions on the North MCP Python SDK GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with North MCP Python SDK?
North MCP Python SDK works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is North MCP Python SDK free to use?
Yes, North MCP Python SDK is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
North MCP Python SDK Alternatives — Similar Developer Tools Servers
Looking for alternatives to North MCP Python SDK? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up North MCP Python SDK in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use North MCP Python SDK?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.