https://github.com/naftiko/microsoft-excel-sandbox

This is a repository for providing a sandbox API for Microsoft Excel.
https://github.com/naftiko/microsoft-excel-sandbox

apis sandboxes

Last synced: about 2 months ago
JSON representation

This is a repository for providing a sandbox API for Microsoft Excel.

• Host: GitHub
• URL: https://github.com/naftiko/microsoft-excel-sandbox
• Owner: naftiko
• Created: 2026-02-19T14:47:25.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2026-05-08T23:01:10.000Z (2 months ago)
• Last Synced: 2026-05-09T01:11:17.059Z (2 months ago)
• Topics: apis, sandboxes
• Language: TypeScript
• Homepage:
• Size: 44.9 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Naftiko Microsoft Excel Sandbox

One-click container deploy of a Naftiko Framework capability that wraps the Microsoft Excel API. Backed by mocks at [mocks.naftiko.net](https://mocks.naftiko.net) — no upstream credentials required.

## Run it

[![Run in Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/naftiko/microsoft-excel-sandbox)

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/naftiko/microsoft-excel-sandbox)

[![Run on Google Cloud](https://deploy.cloud.run/button.svg)](https://deploy.cloud.run/?git_repo=https://github.com/naftiko/microsoft-excel-sandbox)

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/new/template?template=https://github.com/naftiko/microsoft-excel-sandbox)

[![Run on Replit](https://replit.com/badge/github/naftiko/microsoft-excel-sandbox)](https://replit.com/github/naftiko/microsoft-excel-sandbox)

The Cloudflare button gives you the full three-protocol surface (MCP + REST + SKILL) via the bundled Worker proxy. The other four buttons expose the MCP server on port 3001 directly. See **[Per-platform behavior](#per-platform-behavior)** below.

## What this deploys

| Adapter | Path | Namespace | Tools / resources |

|---|---|---|---|

| MCP | `POST /mcp` | `microsoft-excel-sandbox-tools` | 3 starter tools |

| REST | `/api/...` | `microsoft-excel-sandbox-api` | 3 REST resources mirroring the MCP tools |

| SKILL | `/skill` | `microsoft-excel-sandbox-skills` | One skill group bundling the starter tools |

Backed by:

- **Microsoft Excel API** at `mocks.naftiko.net/rest/microsoft-excel-api/1.0.0` — hosted in [`naftiko/sandboxes`](https://github.com/naftiko/sandboxes/tree/main/specs)

The MCP server requires a bearer token. The deploy ships a dummy `sk-mcp-YYYYYYYYYYYY` so you can wire it into a client immediately. Real deployments swap before redeploying.

## Starter scope vs. full surface

This capability bootstraps **3 representative GET operations** from the primary OpenAPI (microsoft-excel-api). To expose more operations, edit `capability/shared/microsoft-excel-api-consumes.yml` and `capability/microsoft-excel-sandbox.naftiko.yml` — add a resource per OpenAPI path and a tool per operation.

## Files

| Path | What it is |

|---|---|

| `capability/microsoft-excel-sandbox.naftiko.yml` | The Naftiko Framework capability YAML |

| `capability/shared/microsoft-excel-api-consumes.yml` | Imported `consumes` block — points at the central Microcks mock |

| `capability/shared/secrets.yaml` | Dummy MCP server bearer token |

| `Dockerfile` | Builds on `ghcr.io/naftiko/framework:latest`, copies `capability/` into `/app/` — read by every platform |

| `wrangler.toml` | Cloudflare-only — Durable Object–backed `MicrosoftExcelSandboxContainer` |

| `src/index.ts` | Cloudflare-only — Worker proxy fronting the three engine ports |

| `render.yaml` | Render-only — Blueprint that pins `PORT=3001` to the Dockerfile |

Cloud Run, Railway, and Replit auto-detect the Dockerfile and need no extra config in the repo.

## Per-platform behavior

| Button | Public surface | Notes |

|---|---|---|

| **Cloudflare** | `/mcp` + `/api/...` + `/skill` + landing page on `/` | Worker proxies three ports through one hostname. |

| **Render** | MCP only on `PORT=3001` | Free tier with cold-starts. |

| **Google Cloud Run** | MCP only on `PORT=3001` | Scales to zero. |

| **Railway** | MCP only on the assigned hostname | Auto-detects Dockerfile. |

| **Replit** | MCP only inside the Replit container | Best for "kick the tires" exploration. |

## Local development

```sh

npm install

npm run dev

```

## Source

- OpenAPI source: 

- Naftiko Framework: 

- Mock host: