README.md

cowsay-mcp

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:

npx -y @smithery/cli install @mrseanchow/cowsay-mcp --client claude

Manual Installation

npm install -g cowsay-mcp

Using npx

npx -y cowsay-mcp

🚀 Running on Cursor

Add this to your mcp.json file:

{
  "mcpServers": {
    "cowsay-mcp": {
      "command": "npx",
      "args": ["-y", "cowsay-mcp"]
    }
  }
}

🌊 Running on Windsurf

Add this to your ./codeium/windsurf/model_config.json file:

{
  "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

{
  "name": "cowsay",
  "parameters": {
    "message": "Hello from LLM!",
    "cow": "tux"
  }
}

cowthink Tool

{
  "name": "cowthink",
  "parameters": {
    "message": "What should I say next?",
    "cow": "moose"
  }
}

list_cows Tool

{
  "name": "list_cows",
  "parameters": {}
}

📄 License

MIT License - see LICENSE file for details.