Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions .github/ISSUE_TEMPLATE/audit_false_positive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
name: Audit false positive
about: Report a finding that does not fit your MCP server's intended behavior
title: ""
labels: audit-false-positive
assignees: ""
---

## Finding

- Finding id:
- Tool name:
- MCPLens version:

## Why this looks false positive


## Intended tool behavior


## Sanitized input

Please include the relevant sanitized `tools/list` entry, config, and report snippet. Do
not include secrets, customer data, private URLs, or production payloads.

31 changes: 31 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
name: Bug report
about: Report a reproducible problem with MCPLens
title: ""
labels: bug
assignees: ""
---

## What happened?


## How to reproduce

```sh

```

## Expected behavior


## Environment

- MCPLens version:
- Node.js version:
- OS:

## Logs or input

Please include sanitized `tools/list`, manifest, config, or command output snippets when
they are relevant. Do not include secrets or production data.

20 changes: 20 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
name: Feature request
about: Suggest an improvement for MCPLens
title: ""
labels: enhancement
assignees: ""
---

## Problem


## Proposed behavior


## Alternatives considered


## Additional context


11 changes: 11 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
## Summary


## Testing

- [ ] `npm test`
- [ ] `npm run smoke:pack` if package contents, CLI entry points, or release metadata changed

## Notes


23 changes: 23 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
name: CI

on:
pull_request:
branches: [main]
push:
branches: [main]

jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- uses: actions/setup-node@v4
with:
node-version: 20
cache: npm

- run: npm ci
- run: npm run build
- run: npm test
- run: npm run smoke:pack
18 changes: 18 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Changelog

All notable changes to MCPLens will be documented in this file.

## 0.1.2 - 2026-07-01

### Added

- Local/offline `audit-mcp` command for MCP `tools/list` exports, usage logs, missed prompts, baseline comparison, CI summaries, Markdown reports, JSON reports, and capability recommendations.
- Browser MCP audit profile for browser/session/page action tools, including checks for mutation contracts, preconditions, and trace artifacts.
- OpenAPI-to-MCP `compile` and `build` flow for generating lean TypeScript MCP servers from curated manifests.
- Example API fixtures and impact reports for GitHub, Stripe, Slack, Google Calendar, and Notion.
- Pack smoke test that installs the npm tarball, verifies both `mcplens` and legacy `agentify` binaries, and runs an installed `audit-mcp` command.

### Changed

- Published package contents now include the guide, impact report, CI documentation, examples, changelog, and license alongside the built CLI.

35 changes: 35 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Contributing

Thanks for helping improve MCPLens. This project is still early, so small, focused changes
are easiest to review.

## Development Setup

```sh
npm ci
npm run build
npm test
npm run smoke:pack
```

MCPLens requires Node.js 20 or newer.

## Pull Requests

- Keep changes focused on one behavior or documentation update.
- Add or update tests when behavior changes.
- Run `npm test` before opening a pull request.
- Run `npm run smoke:pack` when package contents, CLI entry points, or release metadata change.
- Avoid committing generated `dist/`, `node_modules/`, local reports, secrets, or `.env` files.

## Local Audit Behavior

The `audit-mcp` command is local and offline by design. If you add audit features, preserve
that contract unless the change explicitly introduces an opt-in network path and documents
it clearly.

## Reporting Issues

Please include the command you ran, your Node.js version, sanitized input snippets when
possible, and the actual output or stack trace.

Loading
Loading