Skip to content

naftiko/microsoft-excel-sandbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 — no upstream credentials required.

Run it

Run in Cloudflare Deploy to Render Run on Google Cloud Deploy on Railway Run on Replit

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 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

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

npm install
npm run dev

Source

About

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

Topics

Resources

Stars

Watchers

Forks

Contributors