npm mcp-nervous-systemstdioMITupdated 1mo ago
Deterministic governance lint for MCP server configurations, plus reference tooling for the 7 rules.
What can you do with nervous system?
Nervous System
Deterministic governance lint for MCP server configurations, plus reference tooling for the 7 rules.
What each tool actually does
| Tool | Does real work? |
|---|---|
audit_mcp_config |
Yes. Deterministic lint, zero dependencies, fully offline, never throws. Checks inline secrets in env, shell wrappers, unpinned packages, auto-install flags, broad filesystem scopes, non-TLS remote transports, unpinned docker tags. Returns findings with severities and a 0-100 score. |
check_preflight |
Yes, when configured. Reads protected_files_list from nervous-system.config.json or NERVOUS_SYSTEM_PROTECTED_LIST. With no list it says so rather than guessing. If the list is unreadable it FAILS CLOSED. |
get_* (everything else) |
No. They return text: the framework, templates, instructions. That is why they are named get_. |
Install
npx mcp-nervous-system
Free local tool: audit_mcp_config
Pass your config as config (object) or config_json (string), e.g. the contents of
claude_desktop_config.json. Returns findings with severities and a 0-100 score.
Hosted API (pay-per-call, x402, USDC on Base)
The write-capable toolset runs server-side and is not in this package.
POST https://api.100levelup.com/x402/audit-mcp- governance lint ($0.05 USDC)GET https://api.100levelup.com/x402/verify-audit- audit-chain verification ($0.005 USDC)
Discovery: /openapi.json and /llms.txt.
2.0.0 breaking changes
emergency_kill_switch->get_kill_switch_instructions. It never stopped anything.verify_audit_chain->get_audit_verification_instructions. It never verified a chain.dispatch_to_llm->get_dispatch_command. It never dispatched.check_preflightno longer matches hardcoded filenames from the author's own server. It reads your list.- Hardcoded fleet counts and violation totals removed from
get_origin_story. A number baked into a package is a fossil the moment it ships.
License
MIT
Install
Add nervous system to your client. Pick the one you use.
claude mcp add mcp-nervous-system -- npx -y mcp-nervous-systemcodex mcp add mcp-nervous-system -- npx -y mcp-nervous-systemamp mcp add mcp-nervous-system -- npx -y mcp-nervous-system{
"mcpServers": {
"mcp-nervous-system": {
"command": "npx",
"args": [
"-y",
"mcp-nervous-system"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp-nervous-system": {
"command": "npx",
"args": [
"-y",
"mcp-nervous-system"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"mcp-nervous-system","command":"npx","args":["-y","mcp-nervous-system"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"mcp-nervous-system": {
"command": "npx",
"args": [
"-y",
"mcp-nervous-system"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp-nervous-system": {
"command": "npx",
"args": [
"-y",
"mcp-nervous-system"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp-nervous-system": {
"command": "npx",
"args": [
"-y",
"mcp-nervous-system"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp-nervous-system": {
"type": "local",
"command": "npx",
"args": [
"-y",
"mcp-nervous-system"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp-nervous-system": {
"command": {
"path": "npx",
"args": [
"-y",
"mcp-nervous-system"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y mcp-nervous-systemRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation16/25
- Maintenance22/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 46 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 |
|---|---|
| 1.12.1Latest | Jul 13, 2026 |
| 1.12.0 | Jul 11, 2026 |
| 1.9.1 | Mar 9, 2026 |
| 1.0.1 | Mar 4, 2026 |