North MCP Python SDK

@cohere-ai

代码仓库

基本信息

分类

开发工具

许可证

MIT

传输方式

stdio

作者

cohere-ai

关于 North MCP Python SDK

An sdk for creating MCP Servers with north

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

North MCP Python SDK 配置

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

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

North MCP Python SDK 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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://git@github.com/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.

常见问题

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 服务器

offprompt

MCP server that lets Claude Code, Cursor or Codex ask you for API keys on a local page and write them to .env. The agent only ever sees key names.

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R