mcps MCP server
Commit 14 Nov 2026A monorepo of containerized FastMCP servers providing specialized tools for GPS calculations and wingfoil spot data.
Juga dikenal sebagai mathbeal/mcps
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 14 Nov 2026
- Lisensi
- MIT
Apa itu mcps MCP?
A monorepo of containerized FastMCP servers providing specialized tools for GPS calculations and wingfoil spot data.
Ringkasan dibuat dari README proyek
Tentang mcps MCP server
Calculating distances between GPS coordinates or analyzing French wingfoil spot conditions is what this collection of containerized FastMCP servers enables. Designed for developers using Claude, these tools run locally via Docker and can be connected to Claude Desktop using the mcp-remote command. The setup uses Docker Compose to manage multiple independent Python 3.14 services simultaneously.
The gps server provides the distance_between_points tool to calculate spans in kilometers and nautical miles using the Haversine formula. The wingfoil server offers access to a database of 30 spots, including tools like list_spots for paginated monthly wind and wave statistics and get_spot for retrieving full 365-day daily condition data.
Beyond these specific utilities, the repository includes specialized Claude Code agents. These agents assist with development tasks such as scaffolding new servers with mcp-builder, performing code reviews with code-reviewer, and managing pull requests through git-ops. This makes the monorepo a complete environment for building and maintaining additional MCP services.
Apa yang bisa Anda lakukan dengannya
- 1Analyze wingfoil weather patternsExamine monthly aggregated wind and wave statistics for various wingfoil spots in France.
- 2Scaffold new MCP servicesGenerate a complete new server structure including a Dockerfile and testing configuration.
- 3Automate code quality checksRun pre-commit hooks and modernize Python type annotations across the repository.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaumathbeal/mcps is public and reachablegithub.com/mathbeal/mcps ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-14github.com/mathbeal/mcps ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubmcps
Personal MCP server monorepo — FastMCP servers for Claude, containerized with Docker.
Each subdirectory is an independent MCP server (Python 3.14 + FastMCP), containerized and configured independently. A single docker compose up starts all of them.
Prerequisites
Docker
Install Docker Engine and the Compose plugin:
# Ubuntu / Debian / WSL2
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
Verify:
docker --version
docker compose version
Quick start
git clone <repo-url> ~/mcps
cd ~/mcps
# Set up the repo
make setup
# Start all servers
docker compose up -d
All servers restart automatically unless stopped (restart: unless-stopped).
| Server | URL | Description |
|---|---|---|
| gps | http://localhost:8101 | Distance between GPS coordinates |
| wingfoil | http://localhost:8102 | French wingfoil spots, raw data for Claude to reason about |
Claude configuration
Add to your Claude claude_desktop_config.json (or equivalent MCP config file):
{
"mcpServers": {
"gps": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8101/mcp"]
},
"wingfoil": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8102/mcp"]
}
}
}
Stop all servers:
docker compose down
Logs
# All servers (live)
docker compose logs -f
# Single server
docker compose logs -f gps
docker compose logs -f wingfoil
# Last N lines
docker compose logs --tail=50 wingfoil
Servers
gps — port 8101
Distance calculator between two GPS coordinates using the Haversine formula.
| Tool | Description |
|---|---|
distance_between_points |
Distance in km and nautical miles between two lat/lon points |
wingfoil — port 8102
French wingfoil spots database — 30 spots with 365-day conditions, raw data for Claude to reason about.
| Tool | Description |
|---|---|
list_spots |
Paginated list of spots with monthly aggregated wind/wave stats and coordinates |
get_spot |
Full 365-day daily conditions for a specific spot |
Claude Code hooks
Hooks are configured in .claude/settings.local.json (gitignored — personal, not committed).
Block --no-verify (PreToolUse)
Prevents bypassing the pre-commit gate on any git commit --no-verify attempt:
{
"hooks": {
"PreToolUse": [{
"matcher": "Bash",
"hooks": [{
"type": "command",
"command": "python3 -c \"import json, sys; data = json.load(sys.stdin); cmd = data.get('tool_input', {}).get('command', ''); print(json.dumps({'continue': False, 'stopReason': 'Blocked: --no-verify bypasses pre-commit hooks. Fix the issues instead.'}) if '--no-verify' in cmd else json.dumps({'continue': True}))\""
}]
}]
}
}
Remind to test before committing (Stop)
Displays a reminder at the end of every Claude Code session:
{
"hooks": {
"Stop": [{
"hooks": [{
"type": "command",
"command": "python3 -c \"import json; print(json.dumps({'systemMessage': 'Reminder: run make test && make lint before committing.'}))\""
}]
}]
}
}
Claude Agents
Agents live in .claude/agents/ and are loaded automatically by Claude Code in this directory. Each agent is a specialized assistant scoped to a task.
mcp-builder — Scaffold a new MCP server
Scaffolds a new server following all project standards from day one: server.py, Dockerfile, pyproject.toml, tests, pre-commit config, and a new entry in docker-compose.yml. Assigns the next available port starting from 8102.
Trigger: "add a new MCP server for X"
code-reviewer — Pre-commit code review
Runs pre-commit run --all-files on all changed repos and fixes failures. Also rewrites docstrings in clear English, adds doctests where applicable, and modernizes type annotations to Python 3.14+ syntax (X | None, list[X], etc.).
Trigger: "review my changes" or use proactively before committing
git-ops — Git and PR operations
Handles PR creation with the correct format ([AI]: <title>), cross-repo change summaries, pre-commit validation across all repos, and safe branch cleanup.
Trigger: "create a PR" or "run pre-commit on all repos"
Adding a new server
Use the mcp-builder agent — describe the new server and it will scaffold everything following project standards (agent-ready from day one).
Development
make test # run pytest --cov on all repos
make lint # run pre-commit on all repos
make setup # uv sync + pre-commit install on all repos
Contributing
See CONTRIBUTING.md for development workflow, coding standards, and PR format.
License
Pertanyaan tentang mcps MCP
How do I start all the MCP servers at once?
You can start all servers simultaneously by running the command docker compose up -d.
Can I use these servers with Claude Desktop?
Yes, you can configure them in your Claude desktop configuration file using the mcp-remote command.
What does the mcp-builder agent do?
The mcp-builder agent scaffolds new MCP servers with all necessary project files like Dockerfiles and tests following project standards.