feat(config): add Grok CLI support and provider-agnostic context guides
- Introduce .grok/context.md for Grok CLI workflows, MCP tool examples, and best practices. - Add .grokignore to optimize context by excluding large files and binaries. - Create CONTEXT.md as a general LLM context guide adaptable across platforms. - Update README.md for provider-agnostic structure, Grok CLI integration, and generalized docs. - Fix paths in config/claude_desktop_config.json to match new repository location.
This commit is contained in:
Gregory Gauthier
parent
83ec950df7
commit
b51c4b2c02
60
.grok/context.md
Normal file
60
.grok/context.md
Normal file
@ -0,0 +1,60 @@
|
|||||||
|
# Grok CLI Context Guide for this Repository (llm-tools)
|
||||||
|
|
||||||
|
This document provides persistent context, best practices, and usage patterns for Grok CLI Agent mode when working in this repository. It is automatically included in context (via .grok/context.md convention or explicit inclusion) to keep interactions model-provider agnostic, efficient, and aligned with the tools/skills here.
|
||||||
|
|
||||||
|
## Core Principles
|
||||||
|
- **Provider Agnostic**: All documentation, prompts, and workflows should work for Claude, Grok, or any MCP-compatible LLM. Avoid platform-specific assumptions (e.g., prefer MCP tools over Claude-only skills where possible). Update README.md, SKILL.md, and sub-READMEs accordingly.
|
||||||
|
- **MCP-First**: Leverage the built-in MCP tools exposed in Grok CLI (prefixed `mcp_dicom-mcp__*`, `mcp_filesystem-mcp__*`, `mcp_playwright-mcp__*`, `mcp_selenium-mcp__*`, `mcp_github__*`, `mcp_us-weather-mcp__*`, etc.). These map directly to the MCP servers in `./mcps/`.
|
||||||
|
- **Sub-Agent System**: Use the `task` tool proactively:
|
||||||
|
- `general`: Multi-step execution, editing, implementation.
|
||||||
|
- `explore`: Fast read-only research, reviews, "how does this work?".
|
||||||
|
- `verify`: Sandbox-aware builds, tests, validation.
|
||||||
|
- `computer`: Desktop interaction (snapshots, clicks, typing, screenshots).
|
||||||
|
- Prefer `delegate` for long-running read-only background work.
|
||||||
|
- **Workflow Priorities** (from system instructions):
|
||||||
|
1. Understand the request.
|
||||||
|
2. Decide on sub-agent for investigation (default to `task` for review/research/bug triage/verification).
|
||||||
|
3. Use `read_file`, `bash` for direct exploration (small tasks).
|
||||||
|
4. `bash` with `background=true` for servers/watchers.
|
||||||
|
5. `delegate` for parallel read-only work.
|
||||||
|
6. `edit_file` (surgical), `write_file` (new/full rewrites).
|
||||||
|
7. Verify with reads, tests, builds.
|
||||||
|
8. `search_web`/`search_x` for up-to-date info.
|
||||||
|
- **Tool Preferences**:
|
||||||
|
- File ops: Dedicated `read_file`/`write_file`/`edit_file` over bash.
|
||||||
|
- Edits: `edit_file` for targeted changes (unique old_string + context); `write_file` only for new files or full overwrites.
|
||||||
|
- Background: Use for dev servers; manage with `process_*` tools.
|
||||||
|
- Schedules: Use `schedule_*` tools for recurring tasks.
|
||||||
|
- Images/Video: `generate_image`/`generate_video`.
|
||||||
|
- Payments/Wallet: `wallet_*`, `paid_request`, `fetch_payment_info`.
|
||||||
|
- Desktop: `computer_*` tools (snapshot first for stable @e refs).
|
||||||
|
- MCP: Call directly (e.g., `mcp_dicom-mcp__dicom_summarize_directory`); see individual MCP READMEs for params.
|
||||||
|
- **Context Management**: This file + `.grokignore` keep context lean. Avoid loading binaries, large dirs, or node_modules. Explicitly include key files (README.md, SKILL.md, specific MCP docs) when needed.
|
||||||
|
|
||||||
|
## Key Directories & When to Use
|
||||||
|
- **mcps/**: Launch MCP servers via scripts (e.g., `bash mcps/dicom_mcp/run_dicom_mcp_server.sh`). Use corresponding `mcp_*` tools in Grok.
|
||||||
|
- dicom_mcp: QA for DICOM (Dixon, SNR, metadata, rendering, validation). Start here for medical imaging tasks. See mcps/dicom_mcp/README.md + docs/.
|
||||||
|
- Others: filesystem (ops), open_meteo (weather), playwright/selenium (browser automation/testing).
|
||||||
|
- **skills/**: Reusable agent instructions. Read `SKILL.md` files for patterns (e.g., mcp-builder for new MCPs, artifacts-builder for UIs, document-skills for Office/PDF). Adapt YAML frontmatter + guidelines into prompts or custom tools. `mcp-builder/SKILL.md` is especially valuable for extending this repo.
|
||||||
|
- **config/** & **.claude/**: Claude-specific; update paths in claude_desktop_config.json for cross-machine use. Ignore for Grok workflows.
|
||||||
|
- **.mcp.json**: Registers MCPs for Claude Code; useful reference for tool signatures.
|
||||||
|
|
||||||
|
## Best Practices for Grok CLI in this Repo
|
||||||
|
- **Exploration**: `task` with `explore` agent first for reviews/research ("review this change", "how does MCP X work?"). Follow with `general` for edits.
|
||||||
|
- **Verification**: Always use `verify` sub-agent for builds/tests/smoke tests before/after changes.
|
||||||
|
- **Editing**: Quote sufficient unique context in `edit_file`. Verify by re-reading the file.
|
||||||
|
- **DICOM QA**: Prefer `mcp_dicom-mcp__*` tools (e.g., `dicom_summarize_directory`, `dicom_compute_snr`, `dicom_render_image`). Use `dicom_read_pixels` + `dicom_compute_snr` with ROIs identified via render.
|
||||||
|
- **Browser Automation**: Choose playwright-mcp for modern snapshots/eval; selenium-mcp for multi-session or specific WebDriver needs. Combine with `computer_*` if testing desktop apps.
|
||||||
|
- **Avoid**: Loading entire node_modules, large image/DICOM dirs (use .grokignore), or Claude-only phrasing. For long research, `delegate` to `explore`.
|
||||||
|
- **Extending**: Follow skills/mcp-builder/SKILL.md phases (research/planning → implementation → evaluation). Use mcp_github__* tools for PRs/commits if working on remote repos.
|
||||||
|
- **Scheduling**: Use `schedule_create` for recurring checks (e.g., daily DICOM validation or security scans).
|
||||||
|
|
||||||
|
## Quick MCP Tool Examples (Grok CLI)
|
||||||
|
- Summarize DICOM dir: `mcp_dicom-mcp__dicom_summarize_directory` (directory=..., recursive=true).
|
||||||
|
- Filesystem write: `mcp_filesystem-mcp__write_file` (after setting default if needed).
|
||||||
|
- Browser: `mcp_playwright-mcp__browser_navigate` or `mcp_selenium-mcp__selenium_navigate`.
|
||||||
|
- Weather: `mcp_uk-weather-mcp__get_forecast` or open-meteo equivalent.
|
||||||
|
|
||||||
|
Refer to this file in prompts: "Follow the Grok CLI context in .grok/context.md, the updated README.md, and relevant SKILL.md files. Keep all outputs provider-agnostic."
|
||||||
|
|
||||||
|
Update this context.md as the repo evolves (e.g., new MCPs, refined workflows). For full tool list, inspect available tools or run `grep -o 'mcp_[^ ]*' -r . --include="*.py" | sort | uniq`.
|
||||||
36
.grokignore
Normal file
36
.grokignore
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
# Grok CLI / xAI agent ignores
|
||||||
|
# Similar to .gitignore but for context management
|
||||||
|
|
||||||
|
# Build / env
|
||||||
|
**/.venv/
|
||||||
|
**/node_modules/
|
||||||
|
**/__pycache__/
|
||||||
|
**/*.pyc
|
||||||
|
**/.poetry/
|
||||||
|
|
||||||
|
# Large data / binaries
|
||||||
|
**/*.dcm
|
||||||
|
**/*.png
|
||||||
|
**/*.jpg
|
||||||
|
**/*.pdf
|
||||||
|
**/*.docx
|
||||||
|
**/*.xlsx
|
||||||
|
**/*.pptx
|
||||||
|
**/img/
|
||||||
|
**/docs/img/
|
||||||
|
|
||||||
|
# Logs / temp
|
||||||
|
**/*.log
|
||||||
|
**/.continue/
|
||||||
|
**/.claude/
|
||||||
|
|
||||||
|
# Vendor / heavy deps
|
||||||
|
**/mcps/playwright_mcp/node_modules/
|
||||||
|
|
||||||
|
# Ignore self
|
||||||
|
.grokignore
|
||||||
|
README.md # Handled separately via context docs
|
||||||
|
|
||||||
|
# Optional: large reference files
|
||||||
|
**/skills/**/reference/
|
||||||
|
**/mcps/dicom_mcp/docs/
|
||||||
88
CONTEXT.md
Normal file
88
CONTEXT.md
Normal file
@ -0,0 +1,88 @@
|
|||||||
|
# LLM Context Guide (llm-tools Repository)
|
||||||
|
|
||||||
|
This document serves as a **provider-agnostic project brief** for any LLM agent or coding assistant (Claude, Grok, Cursor, Continue.dev, Windsurf, etc.) working in this repository. It is designed to be included in context automatically or explicitly.
|
||||||
|
|
||||||
|
Copy, rename, or adapt it as needed:
|
||||||
|
- **Claude Code / Desktop**: Rename to `CLAUDE.md` (or keep as `CONTEXT.md` — Claude often detects common context files).
|
||||||
|
- **Grok CLI**: Use `.grok/context.md` (already present and optimized for Grok's sub-agents and built-in MCP tools).
|
||||||
|
- **Other tools**: Place in root, `.cursor/rules/`, `.continue/rules/`, or equivalent.
|
||||||
|
|
||||||
|
## Project Overview
|
||||||
|
|
||||||
|
A collection of **Model Context Protocol (MCP)** servers and reusable **agent skills/toolkits**. These enable LLMs to perform specialized tasks including:
|
||||||
|
- Medical imaging QA and analysis (DICOM/MRI, body composition, Dixon sequences, T1 mapping, pixel stats, SNR, Philips private tags, segmentation verification).
|
||||||
|
- Browser automation and web testing (Playwright and Selenium MCPs).
|
||||||
|
- Filesystem operations, weather queries (Open-Meteo), document manipulation (DOCX/PDF/PPTX/XLSX), complex HTML artifact generation (React/Tailwind/shadcn), and MCP/skill development guides.
|
||||||
|
|
||||||
|
**Core Philosophy**: MCP provides standardized, workflow-oriented tools that reduce boilerplate and enable natural language interaction. Skills are structured Markdown/YAML guides with best practices that can be adapted across platforms. All documentation and contributions should remain **model-provider agnostic** while noting platform-specific configuration (Claude Desktop/Code, Grok CLI Agent mode, etc.).
|
||||||
|
|
||||||
|
See `README.md` for full structure, setup, MCP descriptions, skills list, and Grok-specific files (`.grokignore`, `.grok/context.md`).
|
||||||
|
|
||||||
|
## MCP Servers (in ./mcps/)
|
||||||
|
|
||||||
|
Use the corresponding built-in `mcp_*` tools where available, or launch via the provided shell scripts (stdio or HTTP transport).
|
||||||
|
|
||||||
|
- **dicom-mcp** (primary focus): 17+ read-only tools for DICOM QA. Key capabilities: directory summarization, Dixon detection, header comparison, sequence validation, pixel statistics/SNR, image rendering (with windowing/ROIs), Philips private tag queries, UID/segmentation verification, T1 mapping analysis.
|
||||||
|
- Launch: `mcps/dicom_mcp/run_dicom_mcp_server.sh` (or with `DICOM_MCP_PII_FILTER=true` for redaction).
|
||||||
|
- Best for non-coders (plain-language QA) and developers (consistent outputs). See `mcps/dicom_mcp/README.md`, `docs/`, and individual tool descriptions.
|
||||||
|
- **filesystem-mcp**: Read/write/update/list/delete/move/copy with session defaults. Based on `@cyanheads/filesystem-mcp-server`.
|
||||||
|
- **open-meteo-mcp**: Current weather + multi-day forecasts (no API key). Supports units and decoded WMO codes.
|
||||||
|
- **playwright-mcp**: Modern browser automation (navigate, click, type, snapshots, JS eval, tabs, waits, screenshots, network/console). Excellent for accessibility and full-page interactions.
|
||||||
|
- **selenium-mcp**: Alternative multi-session browser automation (forms, smart waits, actionable errors, content extraction).
|
||||||
|
|
||||||
|
Additional MCPs (GitHub, US/UK weather, etc.) appear in some environments.
|
||||||
|
|
||||||
|
**Configuration Examples**:
|
||||||
|
- **Claude Code**: Use root `.mcp.json` + `.claude/settings.local.json` (already configured to enable all servers and skills).
|
||||||
|
- **Claude Desktop**: Copy/update `config/claude_desktop_config.json` (fix absolute paths to your machine) to `~/Library/Application Support/Claude/claude_desktop_config.json`.
|
||||||
|
- **Grok CLI Agent mode**: MCP tools are pre-registered (e.g., `mcp_dicom-mcp__dicom_summarize_directory`). Use `task` (sub-agents: `general`, `explore`, `verify`, `computer`), `delegate`, and built-in tools. See `.grok/context.md` for detailed Grok-specific workflows, priorities, and examples.
|
||||||
|
- General: Follow https://modelcontextprotocol.info/docs/. Most servers support Poetry (`poetry install`) and launch scripts.
|
||||||
|
|
||||||
|
## Skills (in ./skills/)
|
||||||
|
|
||||||
|
Structured guides (`SKILL.md` files with YAML frontmatter) for agentic tasks. Load via platform mechanisms or copy relevant sections into context/prompts.
|
||||||
|
|
||||||
|
- **artifacts-builder**: High-quality React + Tailwind + shadcn/ui HTML artifacts (init/bundle scripts, anti-"AI slop" guidelines).
|
||||||
|
- **document-skills/** (docx, pdf, pptx, xlsx): Creation, editing, analysis, forms, OOXML references.
|
||||||
|
- **mcp-builder**: Comprehensive guide for building robust MCP servers (Python FastMCP or Node SDK). Phases: deep research/planning, implementation, evaluation. **Highly recommended** for extending this repo. Emphasizes agent-centric, workflow-focused tools.
|
||||||
|
- **skill-creator**: Instructions for new reusable agent skills.
|
||||||
|
- **webapp-testing**: Playwright examples for local web apps.
|
||||||
|
|
||||||
|
Adapt these for any LLM — they originated with Claude but focus on portable best practices (agent-centric design, avoid boilerplate, evaluate quality).
|
||||||
|
|
||||||
|
## General Best Practices (All Providers)
|
||||||
|
|
||||||
|
- **Provider Agnostic**: Keep outputs, docs, and code free of platform-specific jargon. Prefer MCP tools; treat skills as prompt libraries.
|
||||||
|
- **Workflow**:
|
||||||
|
1. Understand the request and explore with read-only tools first.
|
||||||
|
2. Use sub-agents or equivalent (Grok: `task` with `explore`/`general`/`verify`; Claude: built-in reasoning/skills).
|
||||||
|
3. For code changes: Surgical edits first (`edit_file` equivalent), then verify (tests, re-reads, builds).
|
||||||
|
4. Launch long-running processes (MCP servers, dev watchers) in background where supported.
|
||||||
|
5. For research: Parallel exploration; use web/search tools for up-to-date info.
|
||||||
|
- **Context Management**: Use ignore files (`.grokignore`, `.gitignore`, Claude equivalents) to exclude binaries, large dirs (DICOMs, node_modules, images), logs, and vendor code. Explicitly load only necessary files (README.md, specific SKILL.md, MCP docs).
|
||||||
|
- **Testing & Validation**: Run pytest for Python MCPs, verify MCP registration, test browser flows, validate DICOM outputs against expected QA protocols.
|
||||||
|
- **Extending the Repo**: Follow `skills/mcp-builder/SKILL.md` (research → plan → implement → evaluate). Add new MCPs to `.mcp.json`, update configs, and keep docs agnostic. Use GitHub MCP tools for PRs/commits where available.
|
||||||
|
- **DICOM QA Specifics**: Start with `dicom_summarize_directory` or `dicom_list_files`. Use `dicom_render_image` to identify ROIs before `dicom_read_pixels` or `dicom_compute_snr`. Handle manufacturer differences (Siemens/GE/Philips private tags).
|
||||||
|
- **Commands (common)**:
|
||||||
|
```bash
|
||||||
|
# MCP setup (Python-based)
|
||||||
|
cd mcps/dicom_mcp && poetry install --with dev
|
||||||
|
poetry run pytest -v
|
||||||
|
|
||||||
|
# Launch servers
|
||||||
|
./mcps/dicom_mcp/run_dicom_mcp_server.sh
|
||||||
|
# (or with PII filter: DICOM_MCP_PII_FILTER=true ...)
|
||||||
|
|
||||||
|
# Grok CLI specific: Use built-in mcp_* tools directly
|
||||||
|
# Claude: Rely on .mcp.json + settings
|
||||||
|
```
|
||||||
|
|
||||||
|
## Platform-Specific Notes
|
||||||
|
|
||||||
|
- **Claude**: Full support via `.mcp.json`, `config/claude_desktop_config.json`, `.claude/settings.local.json`, and skills. Legacy files like `CLAUDE.md` (in subdirs) or Anthropic links can be generalized.
|
||||||
|
- **Grok CLI**: Leverages pre-registered MCP tools + sub-agent system. See dedicated `.grok/context.md` and `.grokignore` for optimized workflows (proactive `task`/`delegate`, `edit_file` preference, background processes, etc.).
|
||||||
|
- **Others** (Cursor, Continue, etc.): Load this `CONTEXT.md`, relevant `SKILL.md`, and MCP docs. Configure MCP servers per their docs.
|
||||||
|
|
||||||
|
Refer to this file in every session: "Follow the LLM Context Guide in CONTEXT.md (or .grok/context.md / CLAUDE.md), the main README.md, and relevant SKILL.md files. Maintain provider-agnostic outputs and documentation."
|
||||||
|
|
||||||
|
Update this file, `README.md`, or platform-specific variants as the repository evolves. For new MCPs or skills, start with the `mcp-builder` and `skill-creator` guides.
|
||||||
139
README.md
139
README.md
@ -1,70 +1,119 @@
|
|||||||
# Claude Tools
|
# LLM Tools (MCP & Skills)
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
A collection of Claude skills, and "Model Context Protocol" servers, that are useful to the functional quality team, or anyone else interested in using some of Claude's more exotic capabilities.
|
A collection of Model Context Protocol (MCP) servers and reusable agent skills/toolkits. These enable LLMs (such as Claude, Grok, and others supporting MCP) to perform specialized tasks including medical imaging QA (DICOM), browser automation, filesystem operations, weather queries, document manipulation, artifact generation, webapp testing, MCP development, and more.
|
||||||
|
|
||||||
|
MCP provides a standardized way for models to access external tools and data. Skills are structured guides, prompts, and examples for agentic workflows that can be adapted across platforms.
|
||||||
|
|
||||||
|
This repository originated with a focus on Claude but has been updated to be model-provider agnostic. It works with:
|
||||||
|
- Claude Desktop / Claude Code (via `.mcp.json`, config files, and `.claude/settings.local.json`)
|
||||||
|
- Grok CLI Agent mode (via built-in `mcp_*` tools, `task`/`delegate` sub-agents, and direct MCP support)
|
||||||
|
- Other platforms supporting the MCP specification or equivalent skill/prompt libraries
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
* Python 3.10+
|
* Python 3.10+
|
||||||
* Node.js (for filesystem and playwright MCPs)
|
* Node.js (for filesystem, Playwright, and Selenium MCPs)
|
||||||
* Poetry (for Python-based MCPs)
|
* Poetry (for Python-based MCPs)
|
||||||
* Claude Desktop and/or Claude Code
|
* Platform that supports MCP (Claude Desktop/Code, Grok CLI with MCP tools, or compatible clients)
|
||||||
|
|
||||||
## Structure
|
## Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
claude-tools/
|
llm-tools/
|
||||||
|-- .claude/ Claude Code project settings
|
|-- .claude/ Platform-specific settings (Claude Code)
|
||||||
|-- .mcp.json MCP server registration for Claude Code
|
|-- .mcp.json MCP server registration (for compatible clients like Claude Code)
|
||||||
|-- config/ Config files for Claude Desktop (~/.config/Claude/)
|
|-- config/ Example configs (Claude Desktop; update paths for your environment)
|
||||||
|-- mcps/ MCP servers
|
|-- mcps/ MCP servers
|
||||||
| |-- dicom_mcp/ DICOM medical imaging inspection (17 read-only tools)
|
| |-- dicom_mcp/ DICOM medical imaging inspection and QA (17+ read-only tools for MRI/body composition)
|
||||||
| |-- filesystem_mcp/ File system operations via @cyanheads/filesystem-mcp-server
|
| |-- filesystem_mcp/ Filesystem operations (read/write/list/delete/move/copy via @cyanheads/filesystem-mcp-server)
|
||||||
| |-- open_meteo_mcp/ Global weather data via the Open-Meteo API
|
| |-- open_meteo_mcp/ Global weather data via Open-Meteo API (current + forecast)
|
||||||
| |-- playwright_mcp/ Browser automation via Playwright
|
| |-- playwright_mcp/ Browser automation via Playwright (navigation, clicks, snapshots, JS execution, etc.)
|
||||||
| |-- selenium_mcp/ Browser automation via Selenium WebDriver
|
| |-- selenium_mcp/ Browser automation via Selenium WebDriver (multi-session, forms, waits, screenshots)
|
||||||
|-- skills/ Skill packages
|
|-- skills/ Reusable agent skills and guides (adaptable across platforms)
|
||||||
|-- artifacts-builder/ Build multi-component HTML artifacts with React, Tailwind, shadcn/ui
|
|-- artifacts-builder/ Build complex React + Tailwind + shadcn/ui HTML artifacts
|
||||||
|-- document-skills/ Document creation and manipulation
|
|-- document-skills/ Document creation, editing, analysis (DOCX, PDF, PPTX, XLSX)
|
||||||
| |-- docx/ Word document creation, editing, and analysis
|
| |-- docx/ Word documents
|
||||||
| |-- pdf/ PDF extraction, creation, merging, splitting, and forms
|
| |-- pdf/ PDF extraction, creation, merging, forms
|
||||||
| |-- pptx/ PowerPoint creation, editing, and analysis
|
| |-- pptx/ PowerPoint
|
||||||
| |-- xlsx/ Spreadsheet creation, analysis, and formula support
|
| |-- xlsx/ Spreadsheets with formulas
|
||||||
|-- mcp-builder/ Guide for building MCP servers (Python FastMCP / Node SDK)
|
|-- mcp-builder/ Comprehensive guide for building high-quality MCP servers (Python FastMCP or Node)
|
||||||
|-- skill-creator/ Guide for creating new Claude Code skills
|
|-- skill-creator/ Guide for creating new reusable agent skills
|
||||||
|-- webapp-testing/ Test local web applications with Playwright scripts
|
|-- webapp-testing/ Playwright-based local web application testing examples
|
||||||
```
|
```
|
||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
|
|
||||||
### Claude Code
|
### MCP Servers
|
||||||
|
|
||||||
The `.mcp.json` at the project root registers all MCP servers. Opening this project in Claude Code will make them available. The `.claude/settings.local.json` enables all servers and registers skill paths.
|
The root `.mcp.json` registers all MCP servers for clients that support it (e.g., Claude Code). Launch scripts (`mcps/*/launch_*.sh` or `run_*.sh`) handle stdio or HTTP transport.
|
||||||
|
|
||||||
### Claude Desktop
|
- **For Claude Code**: Open the project; `.claude/settings.local.json` enables servers and skills. The `.mcp.json` makes tools available.
|
||||||
|
- **For Claude Desktop**: Update `config/claude_desktop_config.json` (it currently contains absolute user-specific paths — replace with your own or use `~` equivalents), then copy/symlink to your config directory (typically `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS).
|
||||||
|
- **For Grok CLI Agent mode**: Many MCPs are available as pre-registered tools (prefixed `mcp_dicom-mcp__*`, `mcp_filesystem-mcp__*`, `mcp_playwright-mcp__*`, `mcp_selenium-mcp__*`, `mcp_us-weather-mcp__*`, etc.). Use them directly via function calls, or leverage `task` (for sub-agents like `general`, `explore`, `verify`, `computer`), `delegate`, and built-in tools like `computer_*` for desktop interaction. No extra registration needed in most cases.
|
||||||
|
- **General**: See individual MCP READMEs for Poetry setup, launch commands (stdio vs HTTP), and platform-specific config examples. Most support the official MCP spec (https://modelcontextprotocol.info/docs/).
|
||||||
|
|
||||||
Copy (or symlink) `config/claude_desktop_config.json` to your Claude Desktop config directory:
|
**Note on paths**: The `config/claude_desktop_config.json` has hardcoded absolute paths from a previous location (`/Users/.../pd/claude-tools`). Update these to match your current directory (`/Users/gregory.gauthier/Projects/local/llm-tools`) or generalize with environment variables/`~`.
|
||||||
|
|
||||||
```bash
|
|
||||||
cp config/claude_desktop_config.json ~/Library/Application\ Support/Claude/claude_desktop_config.json
|
|
||||||
```
|
|
||||||
|
|
||||||
## Claude Docs
|
|
||||||
|
|
||||||
### Skills
|
### Skills
|
||||||
|
|
||||||
- **Skills Overview**: [Agent Skills - Claude Docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
|
Skills are loaded via platform-specific mechanisms:
|
||||||
- **Creating Skills in Claude Code**: [Agent Skills - Claude Code Docs](https://code.claude.com/docs/en/skills)
|
- Claude: Via `.claude/settings.local.json` (already configured) or the Skills API.
|
||||||
- **Using Skills with the API**: [Using Agent Skills with the API - Claude Docs](https://platform.claude.com/docs/en/build-with-claude/skills-guide)
|
- Grok / others: Use as prompt libraries, copy relevant sections from `SKILL.md` files into your context, or adapt the structured YAML + instructions for your agent's tool/skill system.
|
||||||
- **Skills API Quickstart**: [Agent Skills - Claude Docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
|
- See `skills/*/SKILL.md` for detailed usage, guidelines, and examples. They originated for Claude but emphasize portable best practices (e.g., agent-centric design, workflow-focused tools).
|
||||||
- **Skills on Console**: [Agent Skills - Claude Docs](https://console.anthropic.com/docs/en/agents-and-tools/agent-skills/overview)
|
|
||||||
- **GitHub - anthropics/skills**: [GitHub - anthropics/skills: Public repository for Agent Skills](https://github.com/anthropics/skills)
|
|
||||||
|
|
||||||
### MCPs
|
## MCP Servers
|
||||||
|
|
||||||
- **MCP Documentation (main)**: [MCP Docs – Model Context Protocol （MCP）](https://modelcontextprotocol.info/docs/)
|
### dicom-mcp
|
||||||
- **MCP Specification**: [GitHub - modelcontextprotocol/modelcontextprotocol: Specification and documentation for the Model Context Protocol](https://github.com/modelcontextprotocol/modelcontextprotocol)
|
Advanced DICOM inspection for QA workflows (MRI, body composition, liver imaging, T1 mapping, Dixon sequences, Philips private tags, pixel statistics, SNR, image rendering, segmentation verification, series consistency, UID comparison, etc.). 17+ tools focused on reducing boilerplate while enabling natural language QA. Ideal for both non-coders (via MCP) and developers. See `mcps/dicom_mcp/README.md` and `docs/` for full capabilities, guidelines, and examples. (Note: Some sub-docs like `CLAUDE.md` and `CAPABILITIES.md` retain legacy Claude framing — consider generalizing further if needed.)
|
||||||
- **MCP Specification Repository**: [GitHub - modelcontextprotocol/modelcontextprotocol: Specification and documentation for the Model Context Protocol](https://github.com/modelcontextprotocol/modelcontextprotocol)
|
|
||||||
- **MCP Documentation Repository**: [GitHub - modelcontextprotocol/docs: Documentation for the Model Context Protocol (MCP)](https://github.com/modelcontextprotocol/docs)
|
### filesystem-mcp
|
||||||
- **MCP in Claude Docs**: https://anthropic.mintlify.app/en/docs/mcp
|
Full filesystem operations (read, write, update with search/replace, list, delete, create/move/copy directories). Supports relative/absolute paths and session defaults. Based on `@cyanheads/filesystem-mcp-server`. See launch scripts and tool descriptions.
|
||||||
|
|
||||||
|
### open-meteo-mcp
|
||||||
|
Current weather and multi-day forecasts (temperature, precipitation, wind, WMO codes, units support) via Open-Meteo API (no key required). Supports stdio and HTTP. See `mcps/open_meteo_mcp/README.md`.
|
||||||
|
|
||||||
|
### playwright-mcp
|
||||||
|
Powerful browser automation with Playwright: navigation, clicks, typing, form filling, screenshots, accessibility snapshots, JS evaluation, tabs, waits, console/network inspection, drag/drop, etc. Excellent for testing and scraping. See `mcps/playwright_mcp/README.md` (minimal; primary docs in bundled MCP).
|
||||||
|
|
||||||
|
### selenium-mcp
|
||||||
|
Alternative browser automation via Selenium WebDriver (multi-session support, smart waits, actionable errors, full page/content extraction). Streamable HTTP transport. See `mcps/selenium_mcp/README.md` for full tool list.
|
||||||
|
|
||||||
|
Additional MCP support (e.g., GitHub, US/UK weather) appears in some environments like Grok CLI.
|
||||||
|
|
||||||
|
## Skills
|
||||||
|
|
||||||
|
- **artifacts-builder**: Creates high-quality, multi-component HTML artifacts with React, TypeScript, Tailwind, shadcn/ui. Includes init/bundle scripts and anti-"slop" guidelines. See `SKILL.md`.
|
||||||
|
- **document-skills**: Comprehensive tools for DOCX, PDF, PPTX, XLSX — creation, editing, analysis, forms, merging, schema references. Subdirectories contain dedicated `SKILL.md` and references.
|
||||||
|
- **mcp-builder**: In-depth guide for building robust MCP servers (Python FastMCP or Node SDK). Covers research/planning, implementation, evaluation, best practices, agent-centric design. Highly recommended. See `SKILL.md`.
|
||||||
|
- **skill-creator**: Instructions for developing new reusable agent skills (structured prompts, examples, evaluation).
|
||||||
|
- **webapp-testing**: Playwright scripts and examples for testing local web applications.
|
||||||
|
|
||||||
|
## Compatibility & Documentation
|
||||||
|
|
||||||
|
- **MCP Specification**: https://github.com/modelcontextprotocol/modelcontextprotocol and https://modelcontextprotocol.info/docs/
|
||||||
|
- **Platform Notes**:
|
||||||
|
- Claude: Full native support; legacy docs in `skills/` and some MCP subfolders reference `claude.ai`, `platform.claude.com`, etc.
|
||||||
|
- Grok: Leverages built-in MCP tool exposure and sub-agent system (`task`, `delegate`, `verify`, `computer_*` tools for desktop). Use `search_web`, `generate_image`, scheduling, wallet tools, etc., alongside these.
|
||||||
|
- Others: Follow the MCP spec; adapt skills as context or custom tools.
|
||||||
|
- Individual MCP/skill folders contain detailed READMEs, `SKILL.md`, and references. Update legacy Claude-specific links/docs as you expand (e.g., replace Anthropic skill links with general MCP/agent guides).
|
||||||
|
|
||||||
|
## Grok CLI Configuration & Context
|
||||||
|
|
||||||
|
**Grok-Specific Setup** (in addition to the general MCP setup above):
|
||||||
|
- **.grokignore**: Controls what is automatically loaded into Grok CLI context (excludes binaries, node_modules, large DICOM/image dirs, build artifacts, legacy Claude folders, and this README to avoid bloat). Similar to .gitignore but focused on context efficiency.
|
||||||
|
- **.grok/context.md**: Persistent context document automatically referenced by Grok CLI. It includes:
|
||||||
|
- Core principles for provider-agnostic workflows.
|
||||||
|
- Sub-agent and tool preferences (e.g., proactive use of `task` with `explore`/`general`/`verify`/`computer`, `edit_file` over broad edits).
|
||||||
|
- Directory guidance, best practices for MCP usage, DICOM QA, browser automation, and extending the repo.
|
||||||
|
- Quick examples for common `mcp_*` tool calls.
|
||||||
|
- Usage: Grok CLI will include `.grok/context.md` by default. Reference it explicitly in prompts: "Follow the Grok CLI context in .grok/context.md, the updated README.md, and relevant SKILL.md files. Keep all outputs and changes provider-agnostic."
|
||||||
|
|
||||||
|
These files make Grok CLI Agent mode first-class in this repository alongside Claude support. See `.grok/context.md` for detailed best practices, workflow priorities, and MCP examples.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Update individual `README.md` / `SKILL.md` files (and `.grok/context.md` as needed) to remain provider-agnostic. Generalize hardcoded paths, Claude-centric examples, and titles where possible (e.g., `CLAUDE.md` → general guidelines). Test MCPs across platforms (Claude Desktop/Code, Grok CLI, others).
|
||||||
|
|
||||||
|
For questions or new MCP/skills, explore the `mcp-builder` and `skill-creator` guides first.
|
||||||
@ -1,24 +1,24 @@
|
|||||||
{
|
{
|
||||||
"mcpServers": {
|
"mcpServers": {
|
||||||
"dicom-mcp": {
|
"dicom-mcp": {
|
||||||
"command": "/Users/gregory.gauthier/Projects/pd/claude-tools/mcps/dicom_mcp/run_dicom_mcp_server.sh"
|
"command": "/Users/gregory.gauthier/Projects/local/llm-tools/mcps/dicom_mcp/run_dicom_mcp_server.sh"
|
||||||
},
|
},
|
||||||
"filesystem": {
|
"filesystem": {
|
||||||
"command": "zsh",
|
"command": "zsh",
|
||||||
"args": ["/Users/gregory.gauthier/Projects/pd/claude-tools/mcps/filesystem_mcp/launch_filesystem_mcp.sh"],
|
"args": ["/Users/gregory.gauthier/Projects/local/llm-tools/mcps/filesystem_mcp/launch_filesystem_mcp.sh"],
|
||||||
"env": {
|
"env": {
|
||||||
"MCP_LOG_LEVEL": "debug",
|
"MCP_LOG_LEVEL": "debug",
|
||||||
"MCP_TRANSPORT_TYPE": "stdio"
|
"MCP_TRANSPORT_TYPE": "stdio"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"open-meteo-mcp": {
|
"open-meteo-mcp": {
|
||||||
"command": "/Users/gregory.gauthier/Projects/pd/claude-tools/mcps/open_meteo_mcp/run_open_meteo_mcp_server.sh"
|
"command": "/Users/gregory.gauthier/Projects/local/llm-tools/mcps/open_meteo_mcp/run_open_meteo_mcp_server.sh"
|
||||||
},
|
},
|
||||||
"playwright-mcp": {
|
"playwright-mcp": {
|
||||||
"command": "/Users/gregory.gauthier/Projects/pd/claude-tools/mcps/playwright_mcp/launch_playwright_mcp.sh"
|
"command": "/Users/gregory.gauthier/Projects/local/llm-tools/mcps/playwright_mcp/launch_playwright_mcp.sh"
|
||||||
},
|
},
|
||||||
"selenium-mcp": {
|
"selenium-mcp": {
|
||||||
"command": "/Users/gregory.gauthier/Projects/pd/claude-tools/mcps/selenium_mcp/launch_selenium_mcp_server.sh"
|
"command": "/Users/gregory.gauthier/Projects/local/llm-tools/mcps/selenium_mcp/launch_selenium_mcp_server.sh"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"preferences": {
|
"preferences": {
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user