fenix-mcp 0.1.0__py3-none-any.whl

fenix_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: fenix-mcp
+Version: 0.1.0
+Summary: Fênix Cloud MCP server implemented in Python
+Author: Fenix 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
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+
+# Fênix MCP — Live Access to Fênix Cloud Data
+
+[![PyPI](https://img.shields.io/pypi/v/fenix-mcp.svg)](https://pypi.org/project/fenix-mcp/) [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
+**Fênix MCP** connects MCP-compatible clients (Codex, Cursor, Context7, Windsurf, VS Code, etc.) directly to the Fênix Cloud APIs. Every tool invocation hits the live backend—no outdated snapshots or hallucinated IDs.
+
+## ❌ Without Fênix MCP
+
+- Manual lookups in the web console slow you down
+- Agents fabricate document status, IDs, or team data
+- Automation workflows stall on stale information
+
+## ✅ With Fênix MCP
+
+- Real-time API calls over STDIO or HTTP
+- Rich toolset: documentation CRUD, work items, modes, rules, TODOs, memories
+- Built for multi-user environments and multiple MCP clients
+
+## 🛠 Requirements
+
+- Python 3.10 or newer
+- Fênix Cloud Personal Access Token (`FENIX_PAT_TOKEN`)
+- Any MCP client (Codex, Cursor, VS Code MCP, etc.)
+
+## 🚀 Installation
+
+### With `pipx` (recommended)
+
+```bash
+pipx install fenix-mcp
+```
+
+### With `pip`
+
+```bash
+pip install --user fenix-mcp
+```
+
+To upgrade:
+
+```bash
+pipx upgrade fenix-mcp
+# or
+pip install --upgrade fenix-mcp
+```
+
+## ▶️ Quick Start
+
+Launch the STDIO server by providing your token (or set `FENIX_PAT_TOKEN` beforehand):
+
+```bash
+fenix-mcp --pat <your-token>
+```
+
+The command accepts all flags supported by `fenix_mcp.main` and responds over STDIO, ready for MCP clients.
+
+## ⚙️ MCP Client Configuration
+
+### Codex CLI (`~/.codex/config.toml`)
+
+```toml
+[mcp_servers.fenix]
+command = "fenix-mcp"
+args = ["--pat", "your-token"]
+```
+
+### Cursor (`~/.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "fenix": {
+      "command": "fenix-mcp",
+      "args": ["--pat", "your-token"],
+      "disabled": false
+    }
+  }
+}
+```
+
+### VS Code (Insiders) / Windsurf (`settings.json`)
+
+```json
+{
+  "modelContextProtocol.mcpServers": {
+    "fenix": {
+      "command": "fenix-mcp",
+      "args": ["--pat", "your-token"]
+    }
+  }
+}
+```
+
+> 💡 Install with `pipx install fenix-mcp --python python3.11` to keep the CLI isolated from your global Python.
+
+## 🌐 Optional HTTP Transport
+
+```bash
+export FENIX_TRANSPORT_MODE=http
+export FENIX_HTTP_PORT=5003
+fenix-mcp --pat <your-token>
+```
+
+Set `FENIX_TRANSPORT_MODE=both` to run STDIO and HTTP simultaneously. The default JSON-RPC endpoint is `http://127.0.0.1:5003/jsonrpc`.
+
+## 🔧 Environment Variables
+
+| Variable | Description | Default |
+| --- | --- | --- |
+| `FENIX_API_URL` | Base URL of Fênix Cloud API | `https://fenix-api.devshire.app` |
+| `FENIX_PAT_TOKEN` | Token used when `--pat` is omitted | empty |
+| `FENIX_TRANSPORT_MODE` | `stdio`, `http`, or `both` | `stdio` |
+| `FENIX_HTTP_HOST` | Host for HTTP transport | `127.0.0.1` |
+| `FENIX_HTTP_PORT` | Port for HTTP transport | `5003` |
+| `FENIX_LOG_LEVEL` | Global log level (`DEBUG`, `INFO`, …) | `INFO` |
+
+> Copy `.env.example` to `.env` for easier customization.
+
+## 🧪 Local Testing
+
+```bash
+pip install -e .[dev]
+pytest
+```
+
+## 🔄 Automation
+
+- **CI (GitHub Actions)** – runs on pushes and pull requests targeting `main`. It installs dependencies, runs `pytest`, builds the distribution artifacts, and uploads them as workflow artifacts.
+- **Publish workflow** – push a tag `v*` (or trigger the "Publish" workflow manually) to build the package and, if `PYPI_API_TOKEN` is set in repository secrets, upload artifacts to PyPI via `twine`.
+
+## 🧰 Available Tools
+
+- `knowledge` – documentation CRUD, work items, modes, rules
+- `productivity` – TODO management
+- `intelligence` – memories and smart operations
+- `initialize` – personalized setup
+- `health` – backend health check
+
+## 🔐 Security Tips
+
+- Store tokens securely (`pass`, keychain, `.env`) and never commit secrets.
+- Revoke tokens when no longer needed.
+- In shared environments, prefer `pipx + FENIX_PAT_TOKEN` exported per session.
+
+## ❓ Troubleshooting
+
+<details>
+<summary><b>"command not found: fenix-mcp"</b></summary>
+
+- Ensure the `pipx`/`pip --user` scripts directory is on your `PATH`.
+- macOS/Linux: `export PATH="$PATH:~/.local/bin"`
+- Windows: check `%APPDATA%\Python\Python311\Scripts` (adjust version as needed).
+
+</details>
+
+<details>
+<summary><b>"401 Unauthorized" or authentication errors</b></summary>
+
+- Confirm `--pat` or `FENIX_PAT_TOKEN` is set correctly.
+- Regenerate tokens in Fênix Cloud if they have expired or been revoked.
+
+</details>
+
+<details>
+<summary><b>Use HTTP and STDIO at the same time</b></summary>
+
+```bash
+export FENIX_TRANSPORT_MODE=both
+fenix-mcp --pat <your-token>
+```
+
+STDIO stays active for MCP clients; HTTP will listen on `FENIX_HTTP_HOST:FENIX_HTTP_PORT`.
+
+</details>
+
+## 🗺 Roadmap
+
+- Official Docker image for Fênix MCP
+- Convenience install scripts (`curl | sh`) for macOS/Linux/Windows
+- Additional integrations (public core documents, more tools)
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a branch: `git checkout -b feat/my-feature`
+3. Install dev dependencies: `pip install -e .[dev]`
+4. Run `pytest`
+5. Open a Pull Request describing your changes
+
+## 📄 License
+
+Distributed under the [MIT License](./LICENSE).

fenix_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,29 @@
+fenix_mcp/__init__.py,sha256=nTREVrJtZzmSmdDZFwDL_ukRPCz4HaYOrGOdEWgze_s,489
+fenix_mcp/main.py,sha256=HfOSB0OfmlnpS6mDxwtjtVYm9cFsNY48cz2cGJJEEXs,2834
+fenix_mcp/application/presenters.py,sha256=fGME54PdCDhTBhXO-JUB9yLdBHiE1aeXLTC2fCuxnxM,689
+fenix_mcp/application/tool_base.py,sha256=OzXbxbPOH-lVoVt9KUXtPE-jd_uP7pkadWWxVnLDqmY,1303
+fenix_mcp/application/tool_registry.py,sha256=ji0Bn4Q7FzDdxWM2LoZSSW2M7wb00Tx79f_hQ-SrnDE,1236
+fenix_mcp/application/tools/__init__.py,sha256=Gi1YvYh-KdL9HD8gLVrknHrxiKKEOhHBEZ02KBXJaKQ,796
+fenix_mcp/application/tools/health.py,sha256=vxtRkn0O7qUqnBZGrE9DqJXGY9dXdqUvRcmzpOULK_E,872
+fenix_mcp/application/tools/initialize.py,sha256=9GbRcnXHDGcgEfpdK5GPnzJuKjBnUIvoTpR_S4lBcm4,4483
+fenix_mcp/application/tools/intelligence.py,sha256=P1Jr0E9KrfL05n7Lz_n0BFknyrDM1UZm9WAai703jqM,11856
+fenix_mcp/application/tools/knowledge.py,sha256=pG9hxjHD8KqoPEMMw1Ckex7n4VQHwgRqedYOR3p9lzI,43386
+fenix_mcp/application/tools/productivity.py,sha256=kIJerVvm-dTK0laqaIBIq-xGXxXLxCKPnkEk5qE4ycg,9843
+fenix_mcp/application/tools/user_config.py,sha256=KdgoSF-Jn15HpKpOYpOifo4bMMy0izK1ZanrZP3E9Jc,6152
+fenix_mcp/domain/initialization.py,sha256=uywqJK942vq1_DFp6TpIyPMC88RF2uCQa5Hke0JUQFM,7181
+fenix_mcp/domain/intelligence.py,sha256=phkNTxLvMB_e5A1Kz5o5Eij9jMmiIPFpNcwEGZT_TEk,4537
+fenix_mcp/domain/knowledge.py,sha256=PCbuW1habq19WgR5DJeRbh4KmCNmIlwl-BI7QENEC0E,19217
+fenix_mcp/domain/productivity.py,sha256=aN4Xmp7j4tS759fe5ATBRpoA2zwCJ6Z0zdjTkjqQp20,6681
+fenix_mcp/domain/user_config.py,sha256=VnKEyWN6kCYtrlw_377NkoHOBcLL4fCNPZy5xHSygMQ,1544
+fenix_mcp/infrastructure/config.py,sha256=i2dAN98jmxDTtFR8Z5EBhExVbdtWf2ofwWOpSlXz7CM,1880
+fenix_mcp/infrastructure/context.py,sha256=slPZ5u6kLSHVogB8zz85CS6JNSi-vWzQGpHQFwWNn5U,471
+fenix_mcp/infrastructure/http_client.py,sha256=MXTeeDPudZnmznO6TVPccpDeNOK-M1C4hI1TiVwTxuY,2476
+fenix_mcp/infrastructure/logging.py,sha256=bHrWlSi_0HshRe3--BK_5nzUszW-gh37q6jsd0ShS2Y,1371
+fenix_mcp/infrastructure/fenix_api/client.py,sha256=SZO5kAJTdUUEA-BVSNHtAB4XWdhI07GyWOT8lsUpPs4,27439
+fenix_mcp/interface/mcp_server.py,sha256=tPDmby17IqAAhMFzi9M9bUBQml4WM9QbQ8iCfCyjdNs,2369
+fenix_mcp/interface/transports.py,sha256=Ur8LRhhccbz74_v_QDnI_WM9OsjBSduGYc1iYw1Uyqg,8011
+fenix_mcp-0.1.0.dist-info/METADATA,sha256=SKW2SRoGuXX_xiuuKZYlJsNYC5nEO6EaddDxYoSsqnc,5744
+fenix_mcp-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fenix_mcp-0.1.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-0.1.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-0.1.0.dist-info/RECORD,,

fenix_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fenix_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fenix-mcp = fenix_mcp.main:run

fenix_mcp-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fenix_mcp