allye-mcp 1.0.2__tar.gz

allye_mcp-1.0.2/PKG-INFO

@@ -0,0 +1,345 @@
+Metadata-Version: 2.4
+Name: allye-mcp
+Version: 1.0.2
+Summary: Fênix Cloud MCP server implemented in Python
+Author: Allye Inc
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=2.5
+Requires-Dist: requests>=2.31
+Requires-Dist: urllib3>=2.0
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: python-json-logger>=2.0
+Requires-Dist: PyJWT[crypto]>=2.8
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+
+<p align="center">
+  <img src="https://allye.devshire.app/logos/logo_allye.png" alt="Allye MCP" width="200" />
+</p>
+
+<p align="center">
+  <strong>Allye MCP Server</strong><br/>
+  Python MCP server for Allye Cloud API integration
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/allye-mcp/"><img src="https://img.shields.io/pypi/v/allye-mcp.svg" alt="PyPI"></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"></a>
+  <a href="https://codecov.io/gh/allye-devshire/allye-mcp-py"><img src="https://codecov.io/gh/allye-devshire/allye-mcp-py/branch/main/graph/badge.svg" alt="codecov"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#configuration">Configuration</a> •
+  <a href="#project-structure">Structure</a> •
+  <a href="./TESTING.md">Testing</a>
+</p>
+
+---
+
+## Overview
+
+Allye MCP connects MCP-compatible clients (Claude Code, Cursor, Windsurf, VS Code, etc.) directly to the Allye Cloud APIs. Every tool invocation hits the live backend—no outdated snapshots or hallucinated IDs.
+
+**Available Tools:**
+- `knowledge` — Documentation CRUD, work items, modes, rules
+- `productivity` — TODO management
+- `intelligence` — Memories and smart operations
+- `user_config` — User configuration documents
+- `initialize` — Personalized setup
+- `health` — Backend health check
+
+---
+
+## Quick Start
+
+```bash
+pipx install allye-mcp                    # Install
+allye-mcp --pat <your-token>              # Run (STDIO mode)
+```
+
+---
+
+## Requirements
+
+| Requirement | Version |
+|-------------|---------|
+| Python | 3.10+ |
+| Allye PAT Token | Required |
+| MCP Client | Claude Code, Cursor, Windsurf, VS Code, etc. |
+
+---
+
+## Installation
+
+### With pipx (recommended)
+
+```bash
+pipx install allye-mcp
+```
+
+### With pip
+
+```bash
+pip install --user allye-mcp
+```
+
+### Upgrade
+
+```bash
+pipx upgrade allye-mcp
+# or
+pip install --upgrade allye-mcp
+```
+
+---
+
+## Configuration
+
+### MCP Client Setup
+
+<details>
+<summary><strong>Claude Code</strong> — ~/.claude/config.toml</summary>
+
+```toml
+[mcp_servers.allye]
+command = "allye-mcp"
+args = ["--pat", "your-token"]
+```
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong> — ~/.cursor/mcp.json</summary>
+
+```json
+{
+  "mcpServers": {
+    "allye": {
+      "command": "allye-mcp",
+      "args": ["--pat", "your-token"],
+      "disabled": false
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>VS Code / Windsurf</strong> — settings.json</summary>
+
+```json
+{
+  "modelContextProtocol.mcpServers": {
+    "allye": {
+      "command": "allye-mcp",
+      "args": ["--pat", "your-token"]
+    }
+  }
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary><strong>Environment Variables</strong></summary>
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ALLYE_API_URL` | Allye Cloud API base URL | `https://allye-api.devshire.app` |
+| `ALLYE_PAT_TOKEN` | Token (alternative to `--pat`) | empty |
+| `ALLYE_TRANSPORT_MODE` | `stdio`, `http`, or `both` | `stdio` |
+| `ALLYE_HTTP_HOST` | HTTP transport host | `127.0.0.1` |
+| `ALLYE_HTTP_PORT` | HTTP transport port | `5003` |
+| `ALLYE_LOG_LEVEL` | Log level (`DEBUG`, `INFO`, etc.) | `INFO` |
+
+See [`.env.example`](./.env.example) for reference.
+
+</details>
+
+<details>
+<summary><strong>HTTP Transport</strong></summary>
+
+```bash
+export ALLYE_TRANSPORT_MODE=http
+export ALLYE_HTTP_PORT=5003
+allye-mcp --pat <your-token>
+```
+
+JSON-RPC endpoint: `http://127.0.0.1:5003/jsonrpc`
+
+Run both STDIO and HTTP:
+
+```bash
+export ALLYE_TRANSPORT_MODE=both
+allye-mcp --pat <your-token>
+```
+
+</details>
+
+---
+
+## Project Structure
+
+```
+allye-mcp-py/
+├── allye_mcp/                  # Main package
+│   ├── main.py                 # Entry point (CLI)
+│   ├── application/            # Use cases and services
+│   ├── domain/                 # Business entities
+│   ├── infrastructure/         # External integrations (API, transport)
+│   └── interface/              # MCP protocol handlers
+├── tests/                      # Test suite
+├── docs/                       # Documentation
+├── pyproject.toml              # Project configuration
+└── .env.example                # Environment template
+```
+
+<details>
+<summary><strong>allye_mcp/</strong> — Package Structure</summary>
+
+| Directory | Responsibility |
+|-----------|----------------|
+| `main.py` | CLI entry point, argument parsing, server bootstrap |
+| `application/` | Use cases, handlers for each MCP tool |
+| `domain/` | Business entities, DTOs, validation |
+| `infrastructure/` | API client, HTTP transport, logging |
+| `interface/` | MCP protocol implementation, tool registration |
+
+### Architecture
+
+```
+MCP Client → interface/ → application/ → infrastructure/ → Allye API
+                              ↓
+                          domain/
+                        (entities)
+```
+
+</details>
+
+---
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Runtime | Python 3.10+ |
+| Validation | Pydantic 2 |
+| HTTP | aiohttp, requests |
+| Config | pydantic-settings |
+| Testing | pytest, pytest-asyncio |
+| Linting | flake8, black, mypy |
+
+---
+
+## Development
+
+### Setup
+
+```bash
+# Clone and install
+git clone <repo>
+cd allye-mcp-py
+pip install -e .[dev]
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `pytest` | Run tests |
+| `pytest --cov=allye_mcp` | Run with coverage |
+| `black allye_mcp/ tests/` | Format code |
+| `flake8 allye_mcp/ tests/` | Lint |
+| `mypy allye_mcp/` | Type check |
+
+### Commit Convention
+
+Follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+| Prefix | Description | Version Bump |
+|--------|-------------|--------------|
+| `fix:` | Bug fixes | Patch |
+| `feat:` | New features | Minor |
+| `BREAKING CHANGE:` | Breaking changes | Major |
+| `chore:` | Maintenance | None |
+| `docs:` | Documentation | None |
+
+---
+
+## CI/CD
+
+| Platform | Usage |
+|----------|-------|
+| GitHub Actions | Tests, lint, build on push/PR to main |
+| Semantic Release | Auto-version based on commits |
+| PyPI | Package distribution |
+
+---
+
+## Troubleshooting
+
+<details>
+<summary><code>command not found: allye-mcp</code></summary>
+
+Add scripts directory to PATH:
+
+```bash
+# macOS/Linux
+export PATH="$PATH:~/.local/bin"
+
+# Windows
+# Add %APPDATA%\Python\Python311\Scripts to PATH
+```
+
+</details>
+
+<details>
+<summary><code>401 Unauthorized</code></summary>
+
+1. Check `--pat` or `ALLYE_PAT_TOKEN` is set correctly
+2. Regenerate token in Allye Cloud if expired
+
+</details>
+
+<details>
+<summary>Run HTTP and STDIO simultaneously</summary>
+
+```bash
+export ALLYE_TRANSPORT_MODE=both
+allye-mcp --pat <your-token>
+```
+
+</details>
+
+---
+
+## Security
+
+- Store tokens securely (keychain, `pass`, `.env`)
+- Never commit secrets to git
+- Revoke tokens when no longer needed
+- Use `pipx` to isolate from global Python
+
+---
+
+## Useful Links
+
+| Resource | URL |
+|----------|-----|
+| PyPI | https://pypi.org/project/allye-mcp/ |
+| Allye Cloud | https://allye.devshire.app |
+| MCP Protocol | https://modelcontextprotocol.io |

allye_mcp-1.0.2/README.md

@@ -0,0 +1,322 @@
+<p align="center">
+  <img src="https://allye.devshire.app/logos/logo_allye.png" alt="Allye MCP" width="200" />
+</p>
+
+<p align="center">
+  <strong>Allye MCP Server</strong><br/>
+  Python MCP server for Allye Cloud API integration
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/allye-mcp/"><img src="https://img.shields.io/pypi/v/allye-mcp.svg" alt="PyPI"></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"></a>
+  <a href="https://codecov.io/gh/allye-devshire/allye-mcp-py"><img src="https://codecov.io/gh/allye-devshire/allye-mcp-py/branch/main/graph/badge.svg" alt="codecov"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#configuration">Configuration</a> •
+  <a href="#project-structure">Structure</a> •
+  <a href="./TESTING.md">Testing</a>
+</p>
+
+---
+
+## Overview
+
+Allye MCP connects MCP-compatible clients (Claude Code, Cursor, Windsurf, VS Code, etc.) directly to the Allye Cloud APIs. Every tool invocation hits the live backend—no outdated snapshots or hallucinated IDs.
+
+**Available Tools:**
+- `knowledge` — Documentation CRUD, work items, modes, rules
+- `productivity` — TODO management
+- `intelligence` — Memories and smart operations
+- `user_config` — User configuration documents
+- `initialize` — Personalized setup
+- `health` — Backend health check
+
+---
+
+## Quick Start
+
+```bash
+pipx install allye-mcp                    # Install
+allye-mcp --pat <your-token>              # Run (STDIO mode)
+```
+
+---
+
+## Requirements
+
+| Requirement | Version |
+|-------------|---------|
+| Python | 3.10+ |
+| Allye PAT Token | Required |
+| MCP Client | Claude Code, Cursor, Windsurf, VS Code, etc. |
+
+---
+
+## Installation
+
+### With pipx (recommended)
+
+```bash
+pipx install allye-mcp
+```
+
+### With pip
+
+```bash
+pip install --user allye-mcp
+```
+
+### Upgrade
+
+```bash
+pipx upgrade allye-mcp
+# or
+pip install --upgrade allye-mcp
+```
+
+---
+
+## Configuration
+
+### MCP Client Setup
+
+<details>
+<summary><strong>Claude Code</strong> — ~/.claude/config.toml</summary>
+
+```toml
+[mcp_servers.allye]
+command = "allye-mcp"
+args = ["--pat", "your-token"]
+```
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong> — ~/.cursor/mcp.json</summary>
+
+```json
+{
+  "mcpServers": {
+    "allye": {
+      "command": "allye-mcp",
+      "args": ["--pat", "your-token"],
+      "disabled": false
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>VS Code / Windsurf</strong> — settings.json</summary>
+
+```json
+{
+  "modelContextProtocol.mcpServers": {
+    "allye": {
+      "command": "allye-mcp",
+      "args": ["--pat", "your-token"]
+    }
+  }
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary><strong>Environment Variables</strong></summary>
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ALLYE_API_URL` | Allye Cloud API base URL | `https://allye-api.devshire.app` |
+| `ALLYE_PAT_TOKEN` | Token (alternative to `--pat`) | empty |
+| `ALLYE_TRANSPORT_MODE` | `stdio`, `http`, or `both` | `stdio` |
+| `ALLYE_HTTP_HOST` | HTTP transport host | `127.0.0.1` |
+| `ALLYE_HTTP_PORT` | HTTP transport port | `5003` |
+| `ALLYE_LOG_LEVEL` | Log level (`DEBUG`, `INFO`, etc.) | `INFO` |
+
+See [`.env.example`](./.env.example) for reference.
+
+</details>
+
+<details>
+<summary><strong>HTTP Transport</strong></summary>
+
+```bash
+export ALLYE_TRANSPORT_MODE=http
+export ALLYE_HTTP_PORT=5003
+allye-mcp --pat <your-token>
+```
+
+JSON-RPC endpoint: `http://127.0.0.1:5003/jsonrpc`
+
+Run both STDIO and HTTP:
+
+```bash
+export ALLYE_TRANSPORT_MODE=both
+allye-mcp --pat <your-token>
+```
+
+</details>
+
+---
+
+## Project Structure
+
+```
+allye-mcp-py/
+├── allye_mcp/                  # Main package
+│   ├── main.py                 # Entry point (CLI)
+│   ├── application/            # Use cases and services
+│   ├── domain/                 # Business entities
+│   ├── infrastructure/         # External integrations (API, transport)
+│   └── interface/              # MCP protocol handlers
+├── tests/                      # Test suite
+├── docs/                       # Documentation
+├── pyproject.toml              # Project configuration
+└── .env.example                # Environment template
+```
+
+<details>
+<summary><strong>allye_mcp/</strong> — Package Structure</summary>
+
+| Directory | Responsibility |
+|-----------|----------------|
+| `main.py` | CLI entry point, argument parsing, server bootstrap |
+| `application/` | Use cases, handlers for each MCP tool |
+| `domain/` | Business entities, DTOs, validation |
+| `infrastructure/` | API client, HTTP transport, logging |
+| `interface/` | MCP protocol implementation, tool registration |
+
+### Architecture
+
+```
+MCP Client → interface/ → application/ → infrastructure/ → Allye API
+                              ↓
+                          domain/
+                        (entities)
+```
+
+</details>
+
+---
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Runtime | Python 3.10+ |
+| Validation | Pydantic 2 |
+| HTTP | aiohttp, requests |
+| Config | pydantic-settings |
+| Testing | pytest, pytest-asyncio |
+| Linting | flake8, black, mypy |
+
+---
+
+## Development
+
+### Setup
+
+```bash
+# Clone and install
+git clone <repo>
+cd allye-mcp-py
+pip install -e .[dev]
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `pytest` | Run tests |
+| `pytest --cov=allye_mcp` | Run with coverage |
+| `black allye_mcp/ tests/` | Format code |
+| `flake8 allye_mcp/ tests/` | Lint |
+| `mypy allye_mcp/` | Type check |
+
+### Commit Convention
+
+Follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+| Prefix | Description | Version Bump |
+|--------|-------------|--------------|
+| `fix:` | Bug fixes | Patch |
+| `feat:` | New features | Minor |
+| `BREAKING CHANGE:` | Breaking changes | Major |
+| `chore:` | Maintenance | None |
+| `docs:` | Documentation | None |
+
+---
+
+## CI/CD
+
+| Platform | Usage |
+|----------|-------|
+| GitHub Actions | Tests, lint, build on push/PR to main |
+| Semantic Release | Auto-version based on commits |
+| PyPI | Package distribution |
+
+---
+
+## Troubleshooting
+
+<details>
+<summary><code>command not found: allye-mcp</code></summary>
+
+Add scripts directory to PATH:
+
+```bash
+# macOS/Linux
+export PATH="$PATH:~/.local/bin"
+
+# Windows
+# Add %APPDATA%\Python\Python311\Scripts to PATH
+```
+
+</details>
+
+<details>
+<summary><code>401 Unauthorized</code></summary>
+
+1. Check `--pat` or `ALLYE_PAT_TOKEN` is set correctly
+2. Regenerate token in Allye Cloud if expired
+
+</details>
+
+<details>
+<summary>Run HTTP and STDIO simultaneously</summary>
+
+```bash
+export ALLYE_TRANSPORT_MODE=both
+allye-mcp --pat <your-token>
+```
+
+</details>
+
+---
+
+## Security
+
+- Store tokens securely (keychain, `pass`, `.env`)
+- Never commit secrets to git
+- Revoke tokens when no longer needed
+- Use `pipx` to isolate from global Python
+
+---
+
+## Useful Links
+
+| Resource | URL |
+|----------|-----|
+| PyPI | https://pypi.org/project/allye-mcp/ |
+| Allye Cloud | https://allye.devshire.app |
+| MCP Protocol | https://modelcontextprotocol.io |

allye_mcp-1.0.2/allye_mcp/__init__.py

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2024 Bruno Fernandes
+# SPDX-License-Identifier: MIT
+
+"""
+Fênix Cloud MCP Server (Python edition).
+"""
+
+__all__ = ["__version__"]
+
+
+__version__ = "1.0.2"

allye_mcp-1.0.2/allye_mcp/application/formatters/__init__.py

@@ -0,0 +1,40 @@
+# SPDX-License-Identifier: MIT
+"""Formatter helpers extracted from legacy monolithic tool."""
+
+from __future__ import annotations
+
+from .api_catalog import _format_api_detail, _format_api_item, _format_api_search_result
+from .board import _format_board
+from .doc import (
+    _extract_name_count,
+    _format_doc,
+    _format_doc_analytics,
+    _format_doc_tree_flat,
+    _format_doc_tree_nested,
+)
+from .skill import (
+    _export_skill_format,
+    _export_skills_merged_format,
+    _format_marketplace_skill,
+    _format_skill,
+)
+from .sprint import _format_sprint
+from .work import _format_work
+
+__all__ = [
+    "_format_work",
+    "_format_board",
+    "_format_sprint",
+    "_format_doc",
+    "_format_doc_tree_flat",
+    "_format_doc_tree_nested",
+    "_extract_name_count",
+    "_format_doc_analytics",
+    "_format_skill",
+    "_format_marketplace_skill",
+    "_export_skill_format",
+    "_export_skills_merged_format",
+    "_format_api_search_result",
+    "_format_api_item",
+    "_format_api_detail",
+]