# frappe-api-mcp

Model Context Protocol (MCP) server that exposes a single `frappe_api` tool to call Frappe REST endpoints under `/api`.

## What it provides

- Tool name: `frappe_api`
- Methods: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`
- Input: `path` (required), `method`, `query`, `body`, `headers`
- Auth: uses `FRAPPE_AUTH_TOKEN` as the `Authorization` header unless overridden

## Requirements

- Node.js 18+
- A reachable Frappe/ERPNext site

## Local setup

```bash
git clone https://github.com/danielsebastianc/frappe-api-mcp.git
cd frappe-api-mcp
npm install
cp .env.example .env
```

Set these environment variables before running:

- `FRAPPE_BASE_URL` (example: `http://localhost:8000`)
- `FRAPPE_AUTH_TOKEN` (example: `token api_key:api_secret`)

## Run

```bash
npm start
```

## Test

```bash
npm test
```

## OpenCode MCP config example

Do not put real secrets in committed config files. Prefer environment injection.

```json
{
  "mcp": {
    "frappe_api": {
      "type": "local",
      "command": ["node", "/path/to/your/folder/mcp/frappe-api-server.mjs"],
      "environment": {
        "FRAPPE_BASE_URL": "http://localhost:8000",
        "FRAPPE_AUTH_TOKEN": "token api_key:api_secret"
      }
    }
  }
}
```