Metadata-Version: 2.4
Name: community-prompt-voting-mcp-server
Version: 0.1.0
Summary: MCP server for community-driven prompt voting and discovery — submit, vote, and find the best AI prompts
Project-URL: Homepage, https://github.com/AiAgentKarl/community-prompt-voting-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/community-prompt-voting-mcp-server
Author-email: AiAgentKarl <coach1916@gmail.com>
License: MIT
Keywords: ai,claude,community,llm,mcp,model-context-protocol,prompts,voting
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# community-prompt-voting-mcp-server

**MCP server for community-driven prompt voting and discovery** — submit, upvote, and find the best AI prompts. Like Reddit/HackerNews, but for prompts.

[![PyPI version](https://badge.fury.io/py/community-prompt-voting-mcp-server.svg)](https://pypi.org/project/community-prompt-voting-mcp-server/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Why Community Prompt Voting?

The best prompts should rise to the top. This MCP server brings democratic voting to AI prompt libraries:

- **Community-driven**: Anyone can submit prompts, anyone can vote
- **Network effect**: More users → better prompts → more users (exponential value)
- **Trending**: Like HackerNews — recent + upvoted prompts surface first
- **Searchable**: Find prompts by keyword, category, or tags

## Tools (7)

| Tool | Description |
|------|-------------|
| `submit_prompt` | Submit a new prompt to the community library |
| `upvote_prompt` | Upvote a prompt (toggle to remove vote) |
| `downvote_prompt` | Downvote a prompt (toggle to remove vote) |
| `get_trending_prompts` | Get trending prompts (score × recency) |
| `get_category_rankings` | Rankings by category |
| `search_prompts` | Search by keyword, category, or tags |
| `get_voting_info` | System statistics and top-rated prompts |

## Installation

```bash
pip install community-prompt-voting-mcp-server
```

## Claude Desktop Configuration

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "community-prompt-voting": {
      "command": "community-prompt-voting-mcp-server"
    }
  }
}
```

## Usage Examples

```
# Discover trending prompts
get_trending_prompts(limit=10)

# Submit a prompt
submit_prompt(
    title="Chain-of-Thought Debugger",
    prompt_text="Walk through this code step by step...",
    category="coding",
    tags="debugging,cot,code"
)

# Vote on a prompt
upvote_prompt(prompt_id="p001", voter_id="my_agent_id")

# Find writing prompts
search_prompts(category="writing", sort_by="score")

# See all categories
get_category_rankings()
```

## Categories

`reasoning` · `coding` · `writing` · `data` · `education` · `creative` · `research` · `productivity` · `roleplay` · `other`

## Data Storage

Prompts and votes are stored locally at `~/.community_prompt_voting_store.json`. The server ships with 5 seed prompts to bootstrap the community experience.

## Network Effect

> "The best prompts rise through community voting. Every new voter makes the library better for everyone."

This server is part of the [AiAgentKarl](https://github.com/AiAgentKarl) MCP ecosystem — 55+ servers for AI agent infrastructure.

## License

MIT
