Skip to content
Back to search

mcps

See every MCP server Claude Code and Codex will load, by scope, across all your projects

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/js0n--mcps/badge.svg)](/listings/js0n--mcps)

HTML

<a href="/listings/js0n--mcps"><img src="/api/listings/js0n--mcps/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

brew install js0n/tap/mcps

Or copy the single `mcps` file anywhere on your `PATH`. It needs Python 3.11 or newer and nothing else.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 78 lines
  1. # mcps
  2. See every MCP server that Claude Code and Codex will load, by scope, across all your projects.
  3. ```
  4. $ mcps -s
  5. GLOBAL every project
  6. ● claude github http api.githubcopilot.com/mcp/
  7. LOCAL ~/code/infra
  8. ● claude 1password stdio 1password-mcp repo only
  9. PROJECT ~/code/app shared in the repo
  10. ● claude app stdio uv run python -m app.mcp_server needs approval
  11. ○ codex spotify stdio run-spotify-mcp.sh ignored: project not trusted
  12. ```
  13. `claude mcp list` and `codex mcp list` only show what's active in the folder you're in, for one tool. `mcps` reads both tools' config files and shows every server in one place, with the scope it lives in.
  14. ## Install
  15. ```sh
  16. brew install js0n/tap/mcps
  17. ```
  18. Or copy the single `mcps` file anywhere on your `PATH`. It needs Python 3.11 or newer and nothing else.
  19. ## Usage
  20. ```sh
  21. mcps # list servers (instant)
  22. mcps -s # also check which Claude Code servers connect (a few seconds)
  23. mcps --scan ~/code # also include every repo directly inside ~/code
  24. mcps --json # machine-readable output
  25. ```
  26. Set `MCPS_SCAN=~/code:~/work` to always include those folders.
  27. ### Scopes
  28. | Scope | Applies to | Claude Code | Codex |
  29. |---|---|---|---|
  30. | global | every project | `~/.claude.json` | `~/.codex/config.toml` |
  31. | local | one folder, private to you | `~/.claude.json`, per project path | (none) |
  32. | project | everyone who clones the repo | `.mcp.json` | `.codex/config.toml` |
  33. Notes in the list:
  34. - **needs approval**: Claude Code asks before it starts a repo's `.mcp.json` servers. Run `claude` in that folder to approve them.
  35. - **ignored: project not trusted**: Codex only reads a repo's `.codex/config.toml` once you trust the project.
  36. - **disabled**: the server has `enabled = false` in Codex config.
  37. - **failing**: with `-s`, Claude Code could not connect to it.
  38. Projects come from the folders Claude Code has opened, the projects Codex knows about, the current folder, and any `--scan` folders. `CLAUDE_CONFIG_DIR` and `CODEX_HOME` are respected. Account connectors (claude.ai, ChatGPT) and plugin servers aren't stored in these files, so they aren't listed. The status check covers Claude Code only, since Codex has no health check command.
  39. ## Repo-only servers
  40. Claude Code's local scope is keyed by folder, but it also applies inside **git worktrees** of that repo. If you give one repo a server with sensitive access, every worktree of it gets that server too.
  41. `mcps guard` starts a server only when the agent runs inside the named repo itself:
  42. ```sh
  43. cd ~/code/infra
  44. claude mcp add --scope local 1password -- mcps guard "$PWD" -- /Applications/1Password.app/Contents/MacOS/1password-mcp
  45. ```
  46. In a worktree, or anywhere else, the guard exits before starting the server, so the agent never connects to it. Subfolders of the repo still work. `mcps` marks guarded servers as **repo only**.
  47. ## Development
  48. ```sh
  49. python3 -m unittest discover -s tests
  50. ```
  51. ## License
  52. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.