使用说明
Jokes By Api Ninjas MCP Server
English |Simplified Chinese| Traditional Chinese
MCP server used to access Jokes By Api Ninjas API.
🚀 Quickly experience using the EMCP platform
EMCP It is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!
Quick Start:
- 🌐 visit EMCP platform
- 📝 Register and log in to your account
- 🎯 enter MCP SquareBrowse all available MCP servers
- 🔍 Search or find this server(
bach-jokes_by_api_ninjas) - 🎉 click Install MCP button
- ✅ Done! Can be used in your application
Advantages of the EMCP platform:
- ✨ Zero configurationNo need to manually edit configuration files
- 🎨 Visual managementEasily manage all MCP servers through a graphical interface
- 🔐 safe and reliableUnified management of API keys and authentication information
- 🚀 One-click installationMCP Square offers a wide range of server options
- 📊 Use statisticsReal time viewing of service invocation status
Visit Now EMCP platform Start your MCP journey!
Introduction
This is an MCP server used to access the Jokes By Api Ninjas API.
- PyPI package name:
bach-jokes_by_api_ninjas - version: 1.0.0
- transmission protocol: stdio
install
Install from PyPI:
pip install bach-jokes_by_api_ninjas
Install from source code:
pip install -e .
run
Method 1: Use UVX (recommended, no installation required)
# 运行(uvx 会自动安装并运行)
uvx --from bach-jokes_by_api_ninjas bach_jokes_by_api_ninjas
# 或指定版本
uvx --from bach-jokes_by_api_ninjas@latest bach_jokes_by_api_ninjas
Method 2: Direct Run (Development Mode)
python server.py
Method 3: Run as a command after installation
# 安装
pip install bach-jokes_by_api_ninjas
# 运行(命令名使用下划线)
bach_jokes_by_api_ninjas
configuration
API certification
This API requires authentication. Please set environment variables:
export API_KEY="your_api_key_here"
environment variable
| Variable Name | Description | Required |
|---|---|---|
API_KEY |
API Key | Yes |
PORT |
Not applicable | No |
HOST |
Not applicable | No |
Use in cursor
Edit cursor MCP configuration file ~/.cursor/mcp.json:
{
"mcpServers": {
"bach-jokes_by_api_ninjas": {
"command": "uvx",
"args": ["--from", "bach-jokes_by_api_ninjas", "bach_jokes_by_api_ninjas"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
Using Claude Desktop
Edit Claude Desktop configuration file claude_desktop_config.json:
{
"mcpServers": {
"bach-jokes_by_api_ninjas": {
"command": "uvx",
"args": ["--from", "bach-jokes_by_api_ninjas", "bach_jokes_by_api_ninjas"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
Available tools
This server provides the following tools:
v1jokes
API Ninjas Jokes API endpoint.
endpoint: GET /v1/jokes
parameter:
limit(string): How many results to return. Must be between 1 and 30. Default is 1.
tech stack
- transmission protocol: stdio
- HTTP client: httpx
license
MIT License - see details LICENSE Document.
development
This server is composed of API-to-MCP Tool generation.
Version: 1.0.0