# PartnerCore

**MCP Server for Business Central AL Development**

[![npm](https://img.shields.io/npm/v/partnercore.svg)](https://www.npmjs.com/package/partnercore)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)

---

## Overview

PartnerCore brings professional AL development capabilities to AI assistants through the Model Context Protocol (MCP). Connect your AI coding assistant to real BC development tools.

**57+ tools** including:
- AL Language Server with full LSP support
- BC Container management
- Git operations
- File system operations
- Project memory
- Cloud AI services (optional)

---

## Installation

```bash
npm install -g partnercore
```

---

## Configuration

### Cursor

Add to `~/.cursor/mcp.json` (Windows: `%USERPROFILE%\.cursor\mcp.json`):

```json
{
  "mcpServers": {
    "partnercore": {
      "command": "partnercore",
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
```

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "partnercore": {
      "command": "partnercore",
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
```

### VS Code + GitHub Copilot

Add to `.vscode/settings.json`:

```json
{
  "github.copilot.chat.mcpServers": {
    "partnercore": {
      "command": "partnercore",
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
```

> **Note:** `API_KEY` is required for the MCP server to function.

---

## Getting Started

After configuration, reload MCP servers and ask your AI:

> **"Call al_get_started"**

This returns available tools, workspace status, and recommended workflows.

---

## Features

### AL Language Server
Real compiler integration with diagnostics, code completion, symbol navigation, refactoring, and formatting.

### BC Container Tools
Create, compile, publish, and test AL apps in Business Central Docker containers.

### Git Operations
Full version control: status, diff, commit, push, branches, and stash management.

### File Operations
Read, write, search, and manipulate files with pattern matching and regex support.

### Project Memory
Persist project context across development sessions.

### Cloud AI (Optional)
Code review, knowledge base search, and code templates with API key.

---

## CLI Commands

```bash
# Start MCP server (runs by default)
partnercore

# Or explicitly
partnercore start

# Check configuration
partnercore check

# Download AL extension
partnercore download-extension

# Show version
partnercore --version
```

---

## Environment Variables

| Variable | Description |
|----------|-------------|
| `API_KEY` | API key for cloud AI features |
| `LOG_LEVEL` | Logging level (debug, info, warn, error) |

---

## Requirements

- Node.js 18.0.0+
- Windows, macOS, or Linux
- Docker (for container tools)
- Git (for version control tools)

---

## Support

- **Website:** [ciellos.com](https://www.ciellos.com)
- **Issues:** [GitHub](https://github.com/ciellosinc/PartnerCore-MCP/issues)

---

## License

MIT © [Ciellos](https://www.ciellos.com)