# personal-mcp

A personal MCP server for connecting your own API integrations and exposing them as tools/resources/prompts.

## Initial Scope
- Fitness domain
- Hevy provider integration

## Project Structure

```text
personal-mcp/
├── .github/
│   └── copilot-instructions.md
├── src/
│   ├── core/
│   │   ├── server/
│   │   ├── config/
│   │   ├── types/
│   │   └── utils/
│   ├── domains/
│   │   └── fitness/
│   │       ├── providers/
│   │       │   └── hevy/
│   │       ├── services/
│   │       ├── tools/
│   │       ├── resources/
│   │       ├── prompts/
│   │       └── types/
│   └── index.ts
├── tests/
│   ├── core/
│   └── domains/
│       └── fitness/
├── .env.example
├── package.json
├── tsconfig.json
└── README.md
```

## Quick Start

1. Install dependencies.
2. Copy `.env.example` to `.env` and set your API key(s).
3. Start in dev mode.

```bash
npm install
npm run dev
```

## Next Steps
- Implement Hevy API client methods.
- Add MCP tools for recent workouts, exercise lookup, and training volume summaries.
- Add domain-focused tests under `tests/domains/fitness`.