mcp-windows/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code when working with this repository.

Project Overview

mcp_windows -- MCP server for interfacing with the Windows desktop system (audio, display, processes, services, power management, etc.)

Field	Value
Platform	mcp-server
Language	TypeScript
Default branch	main
License	GPL-3.0-or-later
Wiki	mcp-windows Wiki
Standards	MokoStandards

Common Commands

make build        # Build the project
make lint         # Run linters
make validate     # Validate structure
make release      # Full release pipeline
make clean        # Clean build artifacts

npm install       # Install dependencies
npm run build     # Compile TypeScript
npm run dev       # Development mode

Architecture

This is an MCP (Model Context Protocol) server. Key files:

• src/index.ts -- server entry point and tool registration
• src/config.ts -- configuration loading
• src/tools/ -- individual tool implementations
• dist/ -- compiled output (gitignored)

Rules

• Workflow directory: .mokogitea/ (not .gitea/ or .github/)
• Never commit .claude/, .mcp.json, TODO.md, or *.min.css/*.min.js
• Attribution: use Authored-by: Moko Consulting in commits
• Branch strategy: develop on dev, merge to main for release
• Wiki: documentation lives in the Gitea wiki, not in docs/ files
• Standards: this repo follows MokoStandards