npm shipcheck-mcpstdioMITupdated 4mo ago
MCP server that lets local MCP clients run Shipcheck on authorized JavaScript and TypeScript repositories.
What can you do with Shipcheck MCP?
shipcheck-mcp
MCP server that lets local MCP clients run Shipcheck on authorized JavaScript and TypeScript repositories.
Shipcheck scans apps and MCP servers for launch risks such as exposed private-looking env vars, unsigned Stripe webhooks, missing Supabase/Firebase rule evidence, debug routes, missing usage-cost guardrails, missing CI, loose dependencies, thin release docs, missing MCP smoke-test proof, undocumented STDIO execution boundaries, and undocumented remote MCP auth boundaries.
Tool page: https://tateprograms.com/shipcheck.html
Free MCP launch self-check: https://tateprograms.com/mcp-self-check.html
MCP directory launch checklist: https://tateprograms.com/mcp-directory-checklist.html
Paid MCP launch check: https://tateprograms.com/mcp-launch-review.html
Official MCP Registry: https://registry.modelcontextprotocol.io/v0/servers?search=shipcheck
Install
Run directly with npx:
npx --yes shipcheck-mcp
MCP Config
Add this server to an MCP client that supports stdio servers:
{
"mcpServers": {
"shipcheck": {
"command": "npx",
"args": ["--yes", "--package", "shipcheck-mcp", "shipcheck-mcp"]
}
}
}
STDIO MCP client config launches a local command. Review the command, args, and any env values before running generated configs, keep the package source trusted, and prefer pinned package versions when a deployment needs repeatability.
Tool
scan_repository
{
"root": ".",
"format": "markdown",
"failOn": "medium",
"strict": true
}
Formats: text, markdown, json, or sarif.
Severities: info, low, medium, or high.
Shipcheck is defensive static analysis, not a penetration test. It reads local project files, does not modify the repository, does not execute project code, and does not require network access. Run it only on repos you own or are authorized to inspect.
Development
npm install
npm run check
Install
Add Shipcheck MCP to your client. Pick the one you use.
claude mcp add shipcheck-mcp -- npx -y shipcheck-mcpcodex mcp add shipcheck-mcp -- npx -y shipcheck-mcpamp mcp add shipcheck-mcp -- npx -y shipcheck-mcp{
"mcpServers": {
"shipcheck-mcp": {
"command": "npx",
"args": [
"-y",
"shipcheck-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"shipcheck-mcp": {
"command": "npx",
"args": [
"-y",
"shipcheck-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"shipcheck-mcp","command":"npx","args":["-y","shipcheck-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"shipcheck-mcp": {
"command": "npx",
"args": [
"-y",
"shipcheck-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"shipcheck-mcp": {
"command": "npx",
"args": [
"-y",
"shipcheck-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"shipcheck-mcp": {
"command": "npx",
"args": [
"-y",
"shipcheck-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"shipcheck-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"shipcheck-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"shipcheck-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"shipcheck-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y shipcheck-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation22/25
- Maintenance19/25
- Trust13/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 114 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.1.12Latest | May 10, 2026 |
| 0.1.11 | May 9, 2026 |
| 0.1.9 | May 9, 2026 |
| 0.1.8 | May 9, 2026 |
| 0.1.7 | May 9, 2026 |
| 0.1.5 | May 8, 2026 |
| 0.1.4 | May 8, 2026 |
| 0.1.3 | May 8, 2026 |