Agent skill
manage-smithery-deployment
Quick reference for Smithery and Cloudflare deployment operations. Use for deploying Canvas MCP server, managing workers on ariff.dev, and testing OAuth endpoints.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/skills-dicklesworthstone-pi-agent-rust-11
SKILL.md
Skill: Manage Smithery Deployment
Quick Commands
Smithery Operations
# Search for servers
smithery search canvas
smithery list @a-ariff
# Validate config
cd packages/remote-mcp-server-authless
smithery validate
# Publish server
smithery publish
# Check version
smithery --version
Cloudflare/Wrangler Operations
# Check auth
wrangler whoami
# Deploy workers
cd packages/remote-mcp-server-authless && npm run deploy
cd packages/cloudflare-canvas-api && npm run deploy
# Check logs
wrangler tail canvas-mcp-sse
wrangler tail canvas-mcp
# List KV namespaces
wrangler kv:namespace list
Git Operations (Natural Style)
# Create feature branch
git checkout -b feat/smithery-fresh-deployment
# Stage changes
git add -A
# Commit with natural messages
git commit -m "chore: remove deprecated smithery configuration"
git commit -m "feat: add fresh smithery deployment with oauth"
git commit -m "docs: update deployment instructions for smithery"
# Push and create PR
git push origin feat/smithery-fresh-deployment
Testing Endpoints
# Test MCP server health
curl https://canvas-mcp-sse.ariff.dev/health
# Test API proxy
curl https://canvas-mcp.ariff.dev/
# Test OAuth discovery
curl https://canvas-mcp-sse.ariff.dev/.well-known/oauth-authorization-server
Configuration Templates
smithery.yaml (OAuth Version)
name: canvas-student-mcp
description: Canvas LMS integration MCP server with OAuth 2.1 authentication
version: "3.0.0"
author: a-ariff
homepage: https://github.com/a-ariff/canvas-student-mcp-server
remote:
transport:
type: sse
url: https://canvas-mcp-sse.ariff.dev/sse
authentication:
type: oauth2
discovery_url: https://canvas-mcp-sse.ariff.dev/.well-known/oauth-authorization-server
Environment Variables
# For local testing
export CANVAS_API_KEY="your-test-key"
export CANVAS_BASE_URL="https://canvas.instructure.com"
export CLIENT_ID="canvas-mcp-client"
export CLIENT_SECRET="development-secret"
Current Status Checklist
- ✅ Smithery CLI v1.6.3 installed
- ⏳ Old server needs removal
- ⏳ Fresh smithery.yaml needs creation
- ✅ Cloudflare workers deployed
- ✅ Domain routing configured
- ⚠️ Multi-user fix needed
Repository Paths
- Main repo:
/Users/ariff/canvas-student-mcp-server/canvas-student-mcp-server - MCP server:
packages/remote-mcp-server-authless/ - API proxy:
packages/cloudflare-canvas-api/ - Smithery config:
packages/remote-mcp-server-authless/smithery.yaml
Important IDs
- ChatGPT Client: HqSTFXhPtTRy2nCUgI0ewhlResFPckU8
- OAUTH_KV: 274766504e584434b6d32de34357de8a
- API_KEYS_KV: c297508f4ae54d72827eb17dc2ceffac
- CACHE_KV: 5d8e432d63fe4a7eb2dcdbe9914ed4c6
- RATE_LIMIT_KV: 2750d79db84441d3a8fd7431ed85344b
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?