Installation
The Shinzo Python instrumentation library works with Python MCP servers built with the core MCP SDK or FastMCP. Simply install the base package:
pip install shinzo
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
The Shinzo Python instrumentation library works with Python MCP servers built with the core MCP SDK or FastMCP. Simply install the base package:
pip install shinzo
Python SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with any OpenTelemetry ingest service including the Shinzo platform.
Choose the example that matches your MCP SDK:
from mcp.server.fastmcp import FastMCP
from shinzo import instrument_server
# Create FastMCP server
mcp = FastMCP(name="my-mcp-server")
# Instrument it with Shinzo
observability = instrument_server(
mcp,
config={
"server_name": "my-mcp-server",
"server_version": "1.0.0",
"exporter_auth": {
"type": "bearer",
"token": "your-api-token"
}
}
)
# Define your tools
@mcp.tool()
def get_weather(city: str) -> str:
"""Get weather for a city."""
return f"Weather for {city}: Sunny"
# Run the server
if __name__ == "__main__":
mcp.run()
from mcp.server import Server
from shinzo import instrument_server
# Create your MCP server
server = Server("my-mcp-server")
# Instrument it with Shinzo
observability = instrument_server(
server,
config={
"server_name": "my-mcp-server",
"server_version": "1.0.0",
"exporter_auth": {
"type": "bearer",
"token": "your-api-token"
}
}
)
# Define your tools
@server.call_tool()
async def get_weather(city: str) -> str:
return f"Weather for {city}: Sunny"
# Clean shutdown
async def shutdown():
await observability.shutdown()
Shinzo automatically detects and instruments your MCP server regardless of which SDK you use:
Both SDKs receive the same comprehensive instrumentation with no additional configuration needed.
exporter_auth)Run the test suite to verify the library's behavior:
# Run all tests
python -m pytest tests/
# Run with coverage report
python -m pytest tests/ --cov=shinzo --cov-report=term-missing
# Run specific test file
python -m pytest tests/test_config.py -v
# Or use make
make test
The test suite validates:
Run all linting checks before submitting a PR:
# Run all linting checks (black, ruff, mypy)
make lint-all
# Or run individual checks
make format # Format code with black
make lint # Run ruff linter
make type-check # Run mypy type checker
This ensures your code passes all CI validation checks locally before pushing.
This package is distributed under the MIT License.
Contributions are welcome! Please see the Contributing Guide for more information.
Python SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with any O
Visão geral
Python SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with any OpenTelemetry ingest service including the Shinzo platform.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Shinzo Py roda localmente via stdio.
Última verificação: 2026-10-28. Python SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with any OpenTelemetry ingest service including the Shinzo platform.