Skip to content
Back to search

mathom

Run and monitor MCP servers locally

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/stephenlacy--mathom/badge.svg)](/listings/stephenlacy--mathom)

HTML

<a href="/listings/stephenlacy--mathom"><img src="/api/listings/stephenlacy--mathom/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.

Get up and running in less than 2 minutes:

# Install the CLI
npm install -g mcx

# Clone and start mathom
git clone https://github.com/stephenlacy/mathom.git
cd mathom
./quickstart.sh  # Builds and starts everything

Visit [http://localhost:5050](http://localhost:5050) and you're ready to go!

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 · 173 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # mathom
  2. <div align="center">
  3. <img src="./assets/hero.jpg" alt="hero" width="100%">
  4. <h3>Local-first MCP platform with OAuth2 for running and monitoring your servers</h3>
  5. <p>
  6. <a href="https://github.com/stephenlacy/mathom/blob/main/LICENSE">
  7. <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License">
  8. </a>
  9. </p>
  10. </div>
  11. I was tired of not having a way to run my MCP servers locally with auth in a way that I could deploy elsewhere.
  12. - **Built-in OAuth2** - Works with MCP clients that support OAuth2
  13. - **Monitoring** - Live logs, metrics, and status tracking
  14. - **Dashboard** - Modern UI with dark/light themes
  15. - **Quick Launch** - Just replace `npx` with `mcx`
  16. ## ⚡ Quick Start
  17. Get up and running in less than 2 minutes:
  18. ```bash
  19. # Install the CLI
  20. npm install -g mcx
  21. # Clone and start mathom
  22. git clone https://github.com/stephenlacy/mathom.git
  23. cd mathom
  24. ./quickstart.sh # Builds and starts everything
  25. ```
  26. Visit [http://localhost:5050](http://localhost:5050) and you're ready to go!
  27. ## Features
  28. ### Core Capabilities
  29. <table>
  30. <tr>
  31. <td width="50%">
  32. **Local-First Architecture**
  33. - Run locally
  34. - Your data and servers stay private
  35. - (AWS/Cloud self-deployment coming soon...)
  36. </td>
  37. <td width="50%">
  38. **Real-Time Monitoring**
  39. - Live server logs
  40. - Performance metrics
  41. - Basic server debugging
  42. </td>
  43. </tr>
  44. </table>
  45. ### UI
  46. <div align="center">
  47. <img src="./assets/screenshot2.jpg" alt="Dashboard Screenshot" width="80%">
  48. <p><i>Real-time monitoring dashboard with live metrics</i></p>
  49. </div>
  50. <div align="center">
  51. <img src="./assets/theme-hero.png" alt="Theme Support" width="80%">
  52. <p><i>light/dark theme support</i></p>
  53. </div>
  54. ## Usage
  55. ### Launch your MCP Servers
  56. ```bash
  57. # launch a server by name
  58. mcx my-mcp-server
  59. # launch from npm package
  60. mcx @modelcontextprotocol/server-filesystem
  61. # with custom arguments
  62. mcx my-server -- --custom-arg value
  63. ```
  64. ### Custom docker servers
  65. STDIO servers in Docker images can be run using the `--docker` flag, they will get wrapped automatically with the mathom-proxy:
  66. ```bash
  67. mcx --docker mcp/github-mcp-server -e GITHUB_PERSONAL_ACCESS_TOKEN='ghp_token'
  68. ```
  69. ### Claude/Cursor
  70. - Claude: `~/Library/Application Support/Claude/claude_desktop_config.json`
  71. - Cursor: `~/.cursor/mcp.json`
  72. ```json
  73. {
  74. "mcpServers": {
  75. "myServer": {
  76. "command": "mcx",
  77. "args": ["my-mcp-server"],
  78. "env": {
  79. "MATHOM_URL": "http://localhost:5050"
  80. }
  81. },
  82. "myDockerServer": {
  83. "command": "mcx",
  84. "args": ["--docker", "mcp/github-mcp-server", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN=ghp_token"],
  85. }
  86. }
  87. }
  88. ```
  89. ### Use with the Inspector
  90. ```bash
  91. npx @modelcontextprotocol/inspector mcx @modelcontextprotocol/server-everything
  92. ```
  93. ## Documentation
  94. ### Installation
  95. **Docker Installation** (Recommended)
  96. ```bash
  97. docker compose up -d
  98. ```
  99. Or use the [quickstart script](./quickstart.sh)
  100. **Manual Installation**
  101. - Docker
  102. - Go
  103. - Node.js
  104. - PostgreSQL
  105. ### Configuration
  106. **Environment Setup**
  107. ```bash
  108. # .env file
  109. BETTER_AUTH_URL=http://localhost:5050 # required
  110. DATABASE_URL=postgresql://... # required
  111. LOG_URL=http://... # required
  112. NODE_DOCKER_IMAGE="you-custom-node-image" # optional
  113. ```
  114. ### Development
  115. **Run locally:**
  116. ```bash
  117. cd dashboard
  118. pnpm install
  119. pnpm dev
  120. cd ../podrift
  121. go run cmd/main.go
  122. ```
  123. #### TODO:
  124. - [x] local-first platform
  125. - [x] OAuth2 auth
  126. - [x] slick dashboard
  127. - [x] run servers in docker
  128. - [ ] team features
  129. ## License MIT
  130. [License](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

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