mcps MCP server
2026년 11월 14일 커밋A monorepo of containerized FastMCP servers providing specialized tools for GPS calculations and wingfoil spot data.
다른 이름 mathbeal/mcps
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- MIT
mcps MCP란?
mcps은(는) MCP server입니다. 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.