Add comprehensive MCP setup guide and integration test template
**Documentation Added:** - docs/MCP_SETUP.md: Complete 400+ line setup guide - Prerequisites and installation steps - Configuration examples for Claude Code - Verification and troubleshooting - 3 usage examples and advanced configuration - End-to-end workflow and quick reference - tests/mcp_integration_test.md: Comprehensive test template - 10 test cases covering all MCP tools - Performance metrics table - Issue tracking and environment setup - Setup and cleanup scripts - .claude/mcp_config.example.json: Example MCP configuration **Documentation Updated:** - STRUCTURE.md: Complete monorepo structure documentation - CLAUDE.md: All Python script paths updated to cli/ prefix - docs/USAGE.md: All command examples updated for monorepo - TODO.md: Current sprint status and completed tasks **Summary:** - Issues #2 and #3 handled (MCP setup guide + integration tests) - All documentation now reflects monorepo structure (cli/ + mcp/) - Tests: 71/71 passing (100%) - Ready for MCP server testing with Claude Code 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
101
STRUCTURE.md
101
STRUCTURE.md
@@ -1,18 +1,30 @@
|
||||
# Repository Structure
|
||||
|
||||
```
|
||||
doc-to-skill/
|
||||
Skill_Seekers/
|
||||
│
|
||||
├── README.md # Main documentation (start here!)
|
||||
├── QUICKSTART.md # 3-step quick start guide
|
||||
├── LICENSE # MIT License
|
||||
├── .gitignore # Git ignore rules
|
||||
├── 📄 Root Documentation
|
||||
│ ├── README.md # Main documentation (start here!)
|
||||
│ ├── CLAUDE.md # Quick reference for Claude Code
|
||||
│ ├── QUICKSTART.md # 3-step quick start guide
|
||||
│ ├── ROADMAP.md # Development roadmap
|
||||
│ ├── TODO.md # Current sprint tasks
|
||||
│ ├── STRUCTURE.md # This file
|
||||
│ ├── LICENSE # MIT License
|
||||
│ └── .gitignore # Git ignore rules
|
||||
│
|
||||
├── 🐍 Core Scripts
|
||||
├── 🔧 CLI Tools (cli/)
|
||||
│ ├── doc_scraper.py # Main scraping tool
|
||||
│ ├── estimate_pages.py # Page count estimator
|
||||
│ ├── enhance_skill.py # AI enhancement (API-based)
|
||||
│ ├── enhance_skill_local.py # AI enhancement (LOCAL, no API)
|
||||
│ └── package_skill.py # Skill packaging tool
|
||||
│ ├── package_skill.py # Skill packaging tool
|
||||
│ └── run_tests.py # Test runner
|
||||
│
|
||||
├── 🌐 MCP Server (mcp/)
|
||||
│ ├── server.py # Main MCP server
|
||||
│ ├── requirements.txt # MCP dependencies
|
||||
│ └── README.md # MCP setup guide
|
||||
│
|
||||
├── 📁 configs/ # Preset configurations
|
||||
│ ├── godot.json
|
||||
@@ -20,15 +32,25 @@ doc-to-skill/
|
||||
│ ├── vue.json
|
||||
│ ├── django.json
|
||||
│ ├── fastapi.json
|
||||
│ ├── steam-inventory.json
|
||||
│ ├── steam-economy.json
|
||||
│ ├── kubernetes.json
|
||||
│ └── steam-economy-complete.json
|
||||
│
|
||||
├── 🧪 tests/ # Test suite (71 tests, 100% pass rate)
|
||||
│ ├── test_config_validation.py
|
||||
│ ├── test_integration.py
|
||||
│ └── test_scraper_features.py
|
||||
│
|
||||
├── 📚 docs/ # Detailed documentation
|
||||
│ ├── CLAUDE.md # Technical architecture
|
||||
│ ├── ENHANCEMENT.md # AI enhancement guide
|
||||
│ ├── UPLOAD_GUIDE.md # How to upload skills
|
||||
│ └── READY_TO_SHARE.md # Sharing checklist
|
||||
│ ├── USAGE.md # Complete usage guide
|
||||
│ ├── TESTING.md # Testing guide
|
||||
│ └── UPLOAD_GUIDE.md # How to upload skills
|
||||
│
|
||||
├── 🔀 .github/ # GitHub configuration
|
||||
│ ├── SETUP_GUIDE.md # GitHub project setup
|
||||
│ ├── ISSUES_TO_CREATE.md # Issue templates
|
||||
│ └── ISSUE_TEMPLATE/ # Issue templates
|
||||
│
|
||||
└── 📦 output/ # Generated skills (git-ignored)
|
||||
├── {name}_data/ # Scraped raw data (cached)
|
||||
@@ -42,14 +64,61 @@ doc-to-skill/
|
||||
### For Users:
|
||||
- **README.md** - Start here for overview and installation
|
||||
- **QUICKSTART.md** - Get started in 3 steps
|
||||
- **configs/** - 8 ready-to-use presets
|
||||
- **configs/** - 7 ready-to-use presets
|
||||
- **mcp/README.md** - MCP server setup for Claude Code
|
||||
|
||||
### For CLI Usage:
|
||||
- **cli/doc_scraper.py** - Main scraping tool
|
||||
- **cli/estimate_pages.py** - Page count estimator
|
||||
- **cli/enhance_skill_local.py** - Local enhancement (no API key)
|
||||
- **cli/package_skill.py** - Package skills to .zip
|
||||
|
||||
### For MCP Usage (Claude Code):
|
||||
- **mcp/server.py** - MCP server (6 tools)
|
||||
- **mcp/README.md** - Setup instructions
|
||||
- **configs/** - Shared configurations
|
||||
|
||||
### For Developers:
|
||||
- **doc_scraper.py** - Main tool (787 lines)
|
||||
- **docs/CLAUDE.md** - Architecture and internals
|
||||
- **docs/ENHANCEMENT.md** - How enhancement works
|
||||
- **docs/USAGE.md** - Complete usage guide
|
||||
- **docs/TESTING.md** - Testing guide
|
||||
- **tests/** - 71 tests (100% pass rate)
|
||||
|
||||
### For Contributors:
|
||||
- **ROADMAP.md** - Development roadmap
|
||||
- **TODO.md** - Current sprint tasks
|
||||
- **.github/SETUP_GUIDE.md** - GitHub setup
|
||||
- **LICENSE** - MIT License
|
||||
- **.gitignore** - What Git ignores
|
||||
- **docs/READY_TO_SHARE.md** - Distribution guide
|
||||
|
||||
## Architecture
|
||||
|
||||
### Monorepo Structure
|
||||
|
||||
The repository is organized as a monorepo with two main components:
|
||||
|
||||
1. **CLI Tools** (`cli/`): Standalone Python scripts for direct command-line usage
|
||||
2. **MCP Server** (`mcp/`): Model Context Protocol server for Claude Code integration
|
||||
|
||||
Both components share the same configuration files and output directory.
|
||||
|
||||
### Data Flow
|
||||
|
||||
```
|
||||
Config (configs/*.json)
|
||||
↓
|
||||
CLI Tools OR MCP Server
|
||||
↓
|
||||
Scraper (cli/doc_scraper.py)
|
||||
↓
|
||||
Output (output/{name}_data/)
|
||||
↓
|
||||
Builder (cli/doc_scraper.py)
|
||||
↓
|
||||
Skill (output/{name}/)
|
||||
↓
|
||||
Enhancer (optional)
|
||||
↓
|
||||
Packager (cli/package_skill.py)
|
||||
↓
|
||||
Skill .zip (output/{name}.zip)
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user