README.md•2.66 kB
# cowsay-mcp
[](https://smithery.ai/server/@mrseanchow/cowsay-mcp) <a href="https://github.com/mrseanchow/cowsay-mcp/stargazers"><img src="https://img.shields.io/github/stars/mrseanchow/cowsay-mcp" alt="Github Stars"></a> <a href="https://github.com/mrseanchow/cowsay-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-purple" alt="License"></a> <a href="https://github.com/mrseanchow/cowsay-mcp/issues/new"><img src="https://img.shields.io/badge/Report a bug-Github-%231F80C0" alt="Report a bug"></a>
Cowsay MCP Server, providing ASCII art cow capabilities for LLMs. This implementation allows language models to generate fun ASCII art cows with custom messages.
## 🛠️ Tools
- `cowsay`: Generate ASCII art with a cow saying your message
- `cowthink`: Generate ASCII art with a cow thinking your message
- `list_cows`: List all available cow characters
## 📦 Installation
### Installing via Smithery
To install cowsay-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mrseanchow/cowsay-mcp):
```bash
npx -y @smithery/cli install @mrseanchow/cowsay-mcp --client claude
```
### Manual Installation
```shell
npm install -g cowsay-mcp
```
### Using npx
```shell
npx -y cowsay-mcp
```
## 🚀 Running on Cursor
Add this to your `mcp.json` file:
```json
{
"mcpServers": {
"cowsay-mcp": {
"command": "npx",
"args": ["-y", "cowsay-mcp"]
}
}
}
```
## 🌊 Running on Windsurf
Add this to your `./codeium/windsurf/model_config.json` file:
```json
{
"mcpServers": {
"cowsay-mcp": {
"command": "npx",
"args": ["-y", "cowsay-mcp"]
}
}
}
```
## 🎨 Available Cow Characters
The server provides a wide variety of cow characters, including but not limited to:
- `default`: The classic cow
- `small`: A smaller version of the default cow
- `tux`: A penguin character
- `moose`: A moose character
- `sheep`: A sheep character
- `dragon`: A dragon character
- `elephant`: An elephant character
- `skeleton`: A skeleton character
- `stimpy`: A Stimpy character
And many more! Use the `list_cows` tool to see all available characters.
## 📝 Example Usage
### cowsay Tool
```json
{
"name": "cowsay",
"parameters": {
"message": "Hello from LLM!",
"cow": "tux"
}
}
```
### cowthink Tool
```json
{
"name": "cowthink",
"parameters": {
"message": "What should I say next?",
"cow": "moose"
}
}
```
### list_cows Tool
```json
{
"name": "list_cows",
"parameters": {}
}
```
## 📄 License
MIT License - see [LICENSE](./LICENSE) file for details.