#MCP Server

Production-ready TypeScript Model Context Protocol (MCP) server exposing utility, GitHub, and Microsoft Teams tools over stdio.

## Why this repository

- Clean MCP server baseline for internal automation and integrations
- GitHub and Microsoft Teams operational tooling in a single service
- Strict TypeScript setup and minimal runtime surface

## Feature overview

### Utility

- `echo`
- `get_time`

### GitHub tools

- `github_status`
- `github_authenticated_user`
- `github_list_repos`
- `github_create_issue`
- `github_list_issues`
- `github_get_file`
- `github_create_pull_request`
- `github_request`

### Microsoft Teams tools

- `teams_send_message` (webhook)
- `teams_send_card` (adaptive card webhook)
- `teams_graph_status` (Graph API)
- `teams_send_dm` (Graph API)

## Requirements

- Node.js 20+
- npm 10+

## Quick start (Windows)

```powershell
cd mcp-server
npm install
copy .env.example .env
```

Populate `.env` before running.

## Environment variables

### Required for GitHub tools

- `GITHUB_TOKEN`

### Optional for Teams webhook tools

- `TEAMS_WEBHOOK_URL`

### Optional for Teams Graph tools

- `TEAMS_TENANT_ID`
- `TEAMS_CLIENT_ID`
- `TEAMS_CLIENT_SECRET`

## Scripts

- `npm run dev` — development mode with `tsx`
- `npm run build` — compile to `dist/`
- `npm run start` — run compiled server
- `npm run clean` — remove `dist/`
- `npm run inspect` — open MCP inspector

## Run modes

Development:

```bash
npm run dev
```

Build + run:

```bash
npm run build
npm run start
```

MCP stdio command:

```bash
node dist/index.js
```

## Security and compliance

- Do not commit `.env` or secrets
- Use least-privilege credentials for GitHub and Microsoft Graph
- Review [SECURITY.md](SECURITY.md) before production use

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).

## License

Distributed under the MIT License. See [LICENSE](LICENSE).