MCP.so
登录

North MCP Python SDK

@cohere-ai

代码仓库

关于 North MCP Python SDK

An sdk for creating MCP Servers with north

#north-mcp#python-sdk#mcp-servers

基本信息

分类

开发工具

许可证

MIT

运行时

python

传输方式

stdio

发布者

cohere-ai

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "north-mcp-python-sdk": {
      "command": "python",
      "args": [
        "your_server.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is North MCP Python SDK?

It is a Python SDK that builds on the original MCP Python SDK, adding authentication support for the North platform. It provides North‑specific features like user identity validation, OAuth token access, debug mode, OpenTelemetry helpers, and a built‑in health check endpoint. It is aimed at developers building MCP servers that integrate with North.

How to use North MCP Python SDK?

Install with uv pip install git+ssh://[email protected]/cohere-ai/north-mcp-python-sdk.git. Then instantiate a NorthMCPServer with options such as port, trusted_issuers, debug, and telemetry. Example servers are available in the examples/ directory. Local testing without North can be done via the MCP Inspector using stdio or Streamable HTTP transport.

Key features of North MCP Python SDK

  • Authentication with North ID tokens and OAuth for third‑party services.
  • Debug mode for detailed logging of authentication and token validation.
  • OpenTelemetry helpers for custom spans and log‑trace correlation.
  • Built‑in health check endpoint (/health) for Kubernetes probes.
  • Support for StreamableHTTP transport (SSE deprecated).
  • Access to user identity and connector access tokens.

Use cases of North MCP Python SDK

  • Build an MCP server that authenticates users through North.
  • Access third‑party services (e.g., Google Drive, Slack) on behalf of the North user.
  • Develop and test the server locally with the MCP Inspector before connecting to North.
  • Deploy the server with health checks and OpenTelemetry observability.

FAQ from North MCP Python SDK

What is North?

North is a custom extension to the original MCP specification. This SDK provides code to enable your server to use authentication with North.

How do I authenticate users?

North sends an X-North-ID-Token with requests. For production, configure trusted_issuers so the server verifies the token was issued by an expected identity provider. For local development, token decoding is done without signature verification.

Can I access the user’s identity and their OAuth tokens?

Yes. Use get_authenticated_user() inside your tool to access user.email and user.connector_access_tokens for third‑party services.

How do I enable debug mode?

Set the environment variable DEBUG=true or pass debug=True to the NorthMCPServer constructor. Debug mode logs request headers, token parsing, and JWT validation details. It should never be enabled in production.

Is OpenTelemetry required?

No. OpenTelemetry is optional. If no TracerProvider is configured, traces become no‑ops. The SDK does not bundle opentelemetry-sdk or OTLP exporters. Pass a TelemetryConfig to opt in.

评论

开发工具 分类下的更多 MCP 服务器

test

prysmaticlabs

Go implementation of Ethereum proof of stake

3.8K

Code Index MCP

johnhuang316

A Model Context Protocol (MCP) server that helps large language models index, search, and analyze code repositories with minimal setup

979

Golf

golf-mcp

Production-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents

834

Test

x1xhlol

FULL Augment Code, Claude Code, Cluely, CodeBuddy, Comet, Cursor, Devin AI, Junie, Kiro, Leap.new, Lovable, Manus, NotionAI, Orchids.app, Perplexity, Poke, Qoder, Replit, Same.dev, Trae, Traycer AI, VSCode Agent, Warp.dev, Windsurf, Xcode, Z.ai Code, Dia & v0. (And other Open Sou

141.7K

test

harlanc

A simple,high performance and secure live media server in pure Rust (RTMP[cluster]/RTSP/WebRTC[whip/whep]/HTTP-FLV/HLS).🦀

2.3K