{
  "markdown": "# Pomera AI Commander (PAC)\n\n<p align=\"center\">\n  <img src=\"resources/icon.png\" alt=\"Pomera - the fluffy Pomeranian mascot\" width=\"128\" height=\"128\">\n</p>\n\n[![Download Latest Release](https://img.shields.io/badge/Download-Latest%20Release-blue?style=for-the-badge&logo=github)](https://github.com/matbanik/Pomera-AI-Commander/releases)\n\nA desktop text \"workbench\" + MCP server: clean, transform, extract, and analyze text fast—manually in a GUI or programmatically from AI assistants (Cursor / Claude Desktop / MCP clients).\n\n> Stop pasting text into 10 random websites. Pomera (GUI + MCP) - do web searches with MCP and save your work as Pomera Notes in case of text corruption in IDE! Your search API keys are stored encrypted in local database instead of JSON config file.\n\n**📊 [Why AI needs Pomera!](docs/tools/analysis-comparison.md)** - Pomera's MCP tools reduce token usage upto 70-80% for deterministic operations.\n\n[Download latest release](https://github.com/matbanik/Pomera-AI-Commander/releases) · Docs: [Tools](docs/tools/INDEX.md) · [MCP Guide](docs/MCP_SERVER_GUIDE.md) · [CrewAI Integration](docs/CREWAI_POMERA_MCP.md) · [Troubleshooting](docs/TROUBLESHOOTING.md)\n\n\n---\n\n## 60-second demo (what to expect)\n![Messy text → clean output → extracted URLs/emails → ready to ship](PAC.gif)\n\n**Best-for workflows**\n- Cleaning pasted logs / PDFs (whitespace, wrapping, stats)\n- Extracting emails/URLs/IDs via regex\n- Normalizing case, sorting, columns\n- Hashing/encoding utilities\n- Letting Cursor/Claude call these as MCP tools in a repeatable pipeline\n\n---\n\n## Prerequisites\n\n**Python 3.8+** is required for all installation methods.\n\n### macOS (Homebrew)\n```bash\n# Tkinter support (replace @3.14 with your Python version)\nbrew install python-tk@3.14\npip3 install requests reportlab python-docx\n```\n\n### Ubuntu/Debian\n```bash\nsudo apt-get install python3-tk\npip3 install requests reportlab python-docx\n```\n\n### Windows\nTkinter is included with Python from [python.org](https://python.org).\n```cmd\npip install requests reportlab python-docx\n```\n\n> **Note:** For PEP 668 protected environments, use `pip3 install --user` or a virtual environment.\n\n---\n\n## Install / Run\n### Option A — Prebuilt executable (recommended)\n[Download from Releases](https://github.com/matbanik/Pomera-AI-Commander/releases) and run.\n\n### Option B — Python (PyPI)\n```bash\npip install pomera-ai-commander\n# then run:\npomera-ai-commander --help\n```\n\n### Option C — Node.js (npm)\n```bash\nnpm install -g pomera-ai-commander\n# then run:\npomera-mcp --help\n```\n\n### Create Desktop Shortcut\nAfter installing via pip or npm, create a desktop shortcut for quick access:\n\n```bash\n# For pip install:\npomera-create-shortcut\n\n# For npm install (from package directory):\npython create_shortcut.py\n```\n\n---\n\n## MCP Server for AI Assistants\n\nPomera exposes 22 text processing tools via MCP. Configure your AI assistant:\n\n**Cursor** (`.cursor/mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"pomera\": {\n      \"command\": \"pomera-ai-commander\",\n      \"timeout\": 3600\n    }\n  }\n}\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n  \"mcpServers\": {\n    \"pomera\": {\n      \"command\": \"pomera-ai-commander\",\n      \"timeout\": 3600\n    }\n  }\n}\n```\n\n> **💡 Tip:** If the simple command doesn't work, use the full path. Find it with:\n> ```bash\n> # For npm install:\n> npm root -g\n> # Then use: <result>/pomera-ai-commander/pomera_mcp_server.py\n>\n> # For pip install:\n> pip show pomera-ai-commander | grep Location\n> ```\n\n> **⏱️ Timeout:** The `\"timeout\": 3600` setting (in seconds) prevents MCP request timeouts during long-running AI operations like `research` and `deepreasoning`. **Cline, Cursor, and Claude Desktop** all default to a 60-second timeout, which is too short for AI calls involving web search + deep reasoning (60-300s). See [Cline #1306](https://github.com/cline/cline/issues/1306).\n\nSee the full [MCP Server Guide](docs/MCP_SERVER_GUIDE.md) for Antigravity, executable configs, and troubleshooting.\n\n<!-- mcp-name: io.github.matbanik/pomera -->\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n",
  "bytes": 4100,
  "sha": "f59f16d581d349d021bf46f3837c6f5c93e36a0890cf159b68cc5cc4d13ced6b",
  "repo_slug": "matbanik/pomera-ai-commander",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matbanik_pomera_c1e32ef0/readme"
}