Skip to content
Back to search

python-sdk

The official Python SDK for Model Context Protocol servers and clients

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/modelcontextprotocol/python-sdk with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/modelcontextprotocol/python-sdk'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/modelcontextprotocol--python-sdk/badge.svg)](/listings/modelcontextprotocol--python-sdk)

HTML

<a href="/listings/modelcontextprotocol--python-sdk"><img src="/api/listings/modelcontextprotocol--python-sdk/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

uv add "mcp[cli]"      # or: pip install "mcp[cli]"

The `cli` extra adds the `mcp` command-line tool (`mcp dev`, `mcp run`, `mcp install`) on top of the SDK; install plain `mcp` if you don't need it. For one-off commands, `uv run --with "mcp[cli]" mcp ...` works without a project.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 126 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # MCP Python SDK
  2. <div align="center">
  3. <strong>Python implementation of the Model Context Protocol (MCP)</strong>
  4. [![PyPI][pypi-badge]][pypi-url]
  5. [![MIT licensed][mit-badge]][mit-url]
  6. [![Python Version][python-badge]][python-url]
  7. [![Documentation][docs-badge]][docs-url]
  8. [![Protocol][protocol-badge]][protocol-url]
  9. [![Specification][spec-badge]][spec-url]
  10. </div>
  11. ## Documentation
  12. **The documentation lives at <https://py.sdk.modelcontextprotocol.io/>.**
  13. It has a [Get started guide](https://py.sdk.modelcontextprotocol.io/get-started/), [What's new in v2](https://py.sdk.modelcontextprotocol.io/whats-new/), the [API reference](https://py.sdk.modelcontextprotocol.io/api/mcp/), and the [migration guide](https://py.sdk.modelcontextprotocol.io/migration/).
  14. ## What is MCP?
  15. The [Model Context Protocol](https://modelcontextprotocol.io) lets you build servers that expose data and functionality to LLM applications in a secure, standardized way. Think of it like a web API, but designed for LLM interactions. With this SDK you can:
  16. - **Build MCP servers** that expose tools, resources, and prompts to any MCP host
  17. - **Build MCP clients** that connect to any MCP server
  18. - Speak every standard transport: stdio, Streamable HTTP, and SSE
  19. ## Requirements
  20. Python 3.11+.
  21. ## Installation
  22. ```bash
  23. uv add "mcp[cli]" # or: pip install "mcp[cli]"
  24. ```
  25. The `cli` extra adds the `mcp` command-line tool (`mcp dev`, `mcp run`, `mcp install`) on top of the SDK; install plain `mcp` if you don't need it. For one-off commands, `uv run --with "mcp[cli]" mcp ...` works without a project.
  26. ## A server in 15 lines
  27. Create a `server.py`:
  28. <!-- snippet-source docs_src/index/tutorial001.py -->
  29. ```python
  30. from mcp.server import MCPServer
  31. mcp = MCPServer("Demo")
  32. @mcp.tool()
  33. def add(a: int, b: int) -> int:
  34. """Add two numbers."""
  35. return a + b
  36. @mcp.resource("greeting://{name}")
  37. def greeting(name: str) -> str:
  38. """Greet someone by name."""
  39. return f"Hello, {name}!"
  40. ```
  41. _Full example: [docs_src/index/tutorial001.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/docs_src/index/tutorial001.py)_
  42. <!-- /snippet-source -->
  43. That's a complete MCP server: one tool, one templated resource. Open it in the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
  44. ```bash
  45. uv run mcp dev server.py
  46. ```
  47. Call `add` with `a=1`, `b=2` and you get `3` back.
  48. Notice what you did **not** write: no JSON Schema (`a: int, b: int` _is_ the schema), no request parsing, no validation code, no protocol handling. Two type-hinted Python functions and a docstring.
  49. [Get started](https://py.sdk.modelcontextprotocol.io/get-started/) takes it from here.
  50. ## A client in 10 lines
  51. The same package is a full MCP **client**. Serve `server.py` over HTTP:
  52. ```bash
  53. uv run mcp run server.py --transport streamable-http
  54. ```
  55. then point a `Client` at it:
  56. ```python
  57. import asyncio
  58. from mcp import Client
  59. async def main() -> None:
  60. async with Client("http://localhost:8000/mcp") as client:
  61. result = await client.call_tool("add", {"a": 1, "b": 2})
  62. print(result.structured_content) # {'result': 3}
  63. asyncio.run(main())
  64. ```
  65. A URL means Streamable HTTP, the transport you deploy. `Client` can also launch a local server as a stdio subprocess or take any custom transport; [Clients](https://py.sdk.modelcontextprotocol.io/client/) has the rest.
  66. ## Contributing
  67. We are passionate about supporting contributors of all levels of experience and would love to see you get involved in the project. See the [contributing guide](https://github.com/modelcontextprotocol/python-sdk/blob/main/CONTRIBUTING.md) to get started.
  68. ## License
  69. This project is licensed under the MIT License. See the [LICENSE](https://github.com/modelcontextprotocol/python-sdk/blob/main/LICENSE) file for details.
  70. [pypi-badge]: https://img.shields.io/pypi/v/mcp.svg
  71. [pypi-url]: https://pypi.org/project/mcp/
  72. [mit-badge]: https://img.shields.io/pypi/l/mcp.svg
  73. [mit-url]: https://github.com/modelcontextprotocol/python-sdk/blob/main/LICENSE
  74. [python-badge]: https://img.shields.io/pypi/pyversions/mcp.svg
  75. [python-url]: https://www.python.org/downloads/
  76. [docs-badge]: https://img.shields.io/badge/docs-python--sdk-blue.svg
  77. [docs-url]: https://py.sdk.modelcontextprotocol.io/
  78. [protocol-badge]: https://img.shields.io/badge/protocol-modelcontextprotocol.io-blue.svg
  79. [protocol-url]: https://modelcontextprotocol.io
  80. [spec-badge]: https://img.shields.io/badge/spec-spec.modelcontextprotocol.io-blue.svg
  81. [spec-url]: https://modelcontextprotocol.io/specification/latest

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.