50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
|
# 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](https://git.mokoconsulting.tech/MokoConsulting/mcp-windows/wiki) |
|
||
|
|
| **Standards** | [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home) |
|
||
|
|
|
||
|
|
## Common Commands
|
||
|
|
|
||
|
|
```bash
|
||
|
|
make build # Build the project
|
||
|
|
make lint # Run linters
|
||
|
|
make validate # Validate structure
|
||
|
|
make release # Full release pipeline
|
||
|
|
make clean # Clean build artifacts
|
||
|
|
```
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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](https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home)
|