allye-mcp 1.4.0

Allye MCP Server
Python MCP server for Allye Cloud API integration

Quick Start • Installation • Configuration • Structure • Testing

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

pipx install allye-mcp                    # Install
allye-mcp --pat <your-token>              # Run (STDIO mode)

Requirements

Installation

With pipx (recommended)

pipx install allye-mcp

With pip

pip install --user allye-mcp

Upgrade

pipx upgrade allye-mcp
# or
pip install --upgrade allye-mcp

Configuration

MCP Client Setup

[mcp_servers.allye]
command = "allye-mcp"
args = ["--pat", "your-token"]

{
  "mcpServers": {
    "allye": {
      "command": "allye-mcp",
      "args": ["--pat", "your-token"],
      "disabled": false
    }
  }
}

{
  "modelContextProtocol.mcpServers": {
    "allye": {
      "command": "allye-mcp",
      "args": ["--pat", "your-token"]
    }
  }
}

export ALLYE_TRANSPORT_MODE=http
export ALLYE_HTTP_PORT=5003
allye-mcp --pat <your-token>

export ALLYE_TRANSPORT_MODE=both
allye-mcp --pat <your-token>

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

MCP Client → interface/ → application/ → infrastructure/ → Allye API
                              ↓
                          domain/
                        (entities)

Tech Stack

Development

Setup

# Clone and install
git clone <repo>
cd allye-mcp-py
pip install -e .[dev]

Scripts

Commit Convention

Follow Conventional Commits:

CI/CD

Troubleshooting

# macOS/Linux
export PATH="$PATH:~/.local/bin"

# Windows
# Add %APPDATA%\Python\Python311\Scripts to PATH

export ALLYE_TRANSPORT_MODE=both
allye-mcp --pat <your-token>

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