# opsenes-mcp

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
[![npm](https://img.shields.io/badge/npm-%40opsenes%2Fmcp--server-cb3837.svg)](https://www.npmjs.com/package/@opsenes/mcp-server)

The official [Model Context Protocol](https://modelcontextprotocol.io) server for
[Opsenes](https://opsenes.in). It exposes Opsenes capabilities as MCP tools,
resources, and prompts so AI clients can operate the platform safely.

> Part of the Opsenes developer tools. See also
> [opsenes-sdk](https://github.com/opsenesai/opsenes-sdk) and
> [opsenes-cli](https://github.com/opsenesai/opsenes-cli).

## Install

```bash
pnpm add -g @opsenes/mcp-server
# run the server binary
opsenes-mcp
```

## Quick start

Add the server to your MCP client configuration:

```json
{
  "mcpServers": {
    "opsenes": {
      "command": "opsenes-mcp",
      "env": { "OPSENES_API_KEY": "your-key" }
    }
  }
}
```

## Packages

| Package                  | Purpose                          |
| ------------------------ | -------------------------------- |
| `@opsenes/mcp-app`       | Server binary (bin: opsenes-mcp) |
| `@opsenes/mcp-server`    | MCP server assembly              |
| `@opsenes/mcp-tools`     | MCP tool definitions             |
| `@opsenes/mcp-resources` | MCP resource definitions         |
| `@opsenes/mcp-prompts`   | MCP prompt definitions           |
| `@opsenes/mcp-transport` | MCP transport layer              |

## Dependency rules

```text
@opsenes/mcp-server
   ├── @opsenes/mcp-tools
   ├── @opsenes/mcp-resources
   ├── @opsenes/mcp-prompts
   ├── @opsenes/mcp-transport
   └── @opsenes/sdk
```

MCP packages **must never** import `@opsenes/cli-*`, terminal UI, or CLI command
implementations. They may depend on `@opsenes/sdk` (never the reverse).

## Development

```bash
pnpm install
pnpm build
pnpm test
pnpm check       # lint + typecheck + tests + dependency-cruiser
```

## Documentation

- [Architecture](./docs/ARCHITECTURE.md)
- [Contributing guide](./CONTRIBUTING.md)
- [Roadmap](./ROADMAP.md)
- [Changelog](./CHANGELOG.md)
- [Security policy](./SECURITY.md)
- [Code of conduct](./CODE_OF_CONDUCT.md)

## Community

- Website: [opsenes.in](https://opsenes.in)
- GitHub: [github.com/opsenesai](https://github.com/opsenesai)
- X: [@opsenes](https://x.com/opsenes)
- LinkedIn: [Opsenes](https://www.linkedin.com/company/opsenes)

## License

[MIT](./LICENSE) (c) Opsenes