mcps MCPサーバー
コミット 2026年11月14日A monorepo of containerized FastMCP servers providing specialized tools for GPS calculations and wingfoil spot data.
別名 mathbeal/mcps
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
mcps MCPとは
A monorepo of containerized FastMCP servers providing specialized tools for GPS calculations and wingfoil spot data.
プロジェクトのREADMEから生成された概要
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.
できること
- 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.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能mathbeal/mcps is public and reachablegithub.com/mathbeal/mcps ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-14github.com/mathbeal/mcps ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るmcps
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
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.