# Quotes By Api Ninjas MCP Server
English | [简体中文](./README.md) | [繁體中文](./README_ZH-TW.md)
An MCP server for accessing Quotes By Api Ninjas API.
## 🚀 Quick Start with EMCP Platform
**[EMCP](https://sit-emcp.kaleido.guru)** is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!
### Quick Start:
1. 🌐 Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)**
2. 📝 Register and login
3. 🎯 Go to **MCP Marketplace** to browse all available MCP servers
4. 🔍 Search or find this server (`bach-quotes_by_api_ninjas`)
5. 🎉 Click the **"Install MCP"** button
6. ✅ Done! You can now use it in your applications
### EMCP Platform Advantages:
- ✨ **Zero Configuration**: No need to manually edit config files
- 🎨 **Visual Management**: Easy-to-use GUI for managing all MCP servers
- 🔐 **Secure & Reliable**: Centralized API key and authentication management
- 🚀 **One-Click Install**: Rich selection of servers in MCP Marketplace
- 📊 **Usage Statistics**: Real-time service call monitoring
Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)** now to start your MCP journey!
---
## Introduction
This is an MCP server for accessing the Quotes By Api Ninjas API.
- **PyPI Package**: `bach-quotes_by_api_ninjas`
- **Version**: 1.0.0
- **Transport Protocol**: stdio
## 安装
### 从 PyPI 安装:
```bash
pip install bach-quotes_by_api_ninjas
```
### 从源码安装:
```bash
pip install -e .
```
## 运行
### 方式 1: 使用 uvx（推荐，无需安装）
```bash
# 运行（uvx 会自动安装并运行）
uvx --from bach-quotes_by_api_ninjas bach_quotes_by_api_ninjas
# 或指定版本
uvx --from bach-quotes_by_api_ninjas@latest bach_quotes_by_api_ninjas
```
### 方式 2: 直接运行（开发模式）
```bash
python server.py
```
### 方式 3: 安装后作为命令运行
```bash
# 安装
pip install bach-quotes_by_api_ninjas
# 运行（命令名使用下划线）
bach_quotes_by_api_ninjas
```
## Configuration
### API Authentication
This API requires authentication. Please set environment variable:
```bash
export API_KEY="your_api_key_here"
```
### Environment Variables
| Variable | Description | Required |
|----------|-------------|----------|
| `API_KEY` | API Key | Yes |
| `PORT` | N/A | No |
| `HOST` | N/A | No |
### Using with Cursor
Edit Cursor MCP config file `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"bach-quotes_by_api_ninjas": {
"command": "uvx",
"args": ["--from", "bach-quotes_by_api_ninjas", "bach_quotes_by_api_ninjas"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
```
### Using with Claude Desktop
Edit Claude Desktop config file `claude_desktop_config.json`:
```json
{
"mcpServers": {
"bach-quotes_by_api_ninjas": {
"command": "uvx",
"args": ["--from", "bach-quotes_by_api_ninjas", "bach_quotes_by_api_ninjas"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
```
## 可用工具
此服务器提供以下工具:
### `v1quotes`
Returns one (or more) random quotes.
**端点**: `GET /v1/quotes`
**参数**:
- `category` (string): category to limit results to. Possible values are: age alone amazing anger architecture art attitude beauty best birthday business car change communications computers cool courage dad dating death design dreams education environmental equality experience failure faith family famous fear fitness food forgiveness freedom friendship funny future god good government graduation great happiness health history home hope humor imagination inspirational intelligence jealousy knowledge leadership learning
- `limit` (number): How many results to return. Must be between 1 and 10. Default is 1.
---
## Tech Stack
- **Transport Protocol**: stdio
- **HTTP Client**: httpx
## License
MIT License - See [LICENSE](./LICENSE) file for details.
## Development
This server is generated by [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) tool.
Version: 1.0.0
