File size: 6,263 Bytes
891fe52 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 | # Polyhedra Startup Flowchart
```
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Polyhedra MCP Server β
β Startup Flow β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Start
β
βΌ
ββββββββββββββββββββββββββ
β Dependencies installed?β
β pip install -e . β
βββββββββ¬βββββββββββββββββ
β
Yes β No
βββββββββββββ΄βββββββββββββ
β β
βΌ βΌ
ββββββββββββββββ ββββββββββββββββββββ
β Run diagnosticβ β Install deps β
β test_quick β β pip install -e . β
ββββββββ¬ββββββββ ββββββββββ¬ββββββββββ
β β
β Pass β
β β
ββββββββββββ¬ββββββββββββββββ
β
βΌ
βββββββββββββββββββββββ
β Config updated? β
β .vscode/settings.jsonβ
βββββββββββ¬ββββββββββββ
β
Yes β No
βββββββββββββ΄ββββββββββββββ
β β
βΌ βΌ
βββββββββββββββ ββββββββββββββββββββββ
β Reload β β See FIX_GUIDE.md β
β VS Code β β Update config β
β Ctrl+Shift+P β ββββββββββββββββββββββ
ββββββββ¬βββββββ
β
βΌ
βββββββββββββββββββββββ
β MCP server auto-startsβ
β (runs in background) β
ββββββββ¬βββββββββββββββ
β
βΌ
βββββββββββββββββββββββ
β Check output panel β
β Ctrl+Shift+U -> MCP β
ββββββββ¬βββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββ
β See "Server ready"? β
ββββββ¬ββββββββββββ¬ββββββββββ
β β
Yesβ β No
β β
βΌ βΌ
ββββββββββ ββββββββββββββββ
β Success!β β Check errors β
βββββ¬βββββ β See β
β β FIX_GUIDE.md β
β ββββββββββββββββ
βΌ
ββββββββββββββββββββββββββββ
β Test in Copilot β
β "Search transformer papers"β
ββββββββββββββββββββββββββββ
β
βΌ
ββββββββββββββββββββββββββββ
β β¨ Start using Polyhedra!β
ββββββββββββββββββββββββββββ
```
---
## Quick Command Reference
### Windows PowerShell
```powershell
# π Diagnostic and testing
.\test_quick.ps1 # Quick diagnostic
.\run_demo.ps1 # Run demo
python test_fix.py # Detailed test
# π§ Development commands
.\.venv\Scripts\Activate.ps1 # Activate virtual environment
python -m pytest # Run tests
python demo_search.py # Run search demo
# π Debug
python -m polyhedra.server # Manually start server (Ctrl+C to stop)
```
### Batch Files
```cmd
test_quick.bat # Quick diagnostic
run_demo.bat # Run demo
```
---
## Three Usage Methods
### 1οΈβ£ Via IDE (Recommended)
```
VS Code starts
β
Auto-start MCP server
β
Use in Copilot chat
β
Polyhedra tools auto-called
```
**Advantages**:
- β
Auto-start
- β
No manual management
- β
Integrated in chat
### 2οΈβ£ Python Scripts
```python
from polyhedra.services.semantic_scholar import SemanticScholarService
import asyncio
async def main():
service = SemanticScholarService()
papers = await service.search("AI", limit=5)
print(papers)
asyncio.run(main())
```
**Advantages**:
- β
Programmatic control
- β
Batch processing
- β
Custom workflows
### 3οΈβ£ Command Line Demo
```powershell
.\run_demo.ps1
```
**Advantages**:
- β
Quick testing
- β
Learn features
- β
No IDE needed
---
## Status Indicators
### β
Running Normally
```
MCP output: [polyhedra] Server ready
Copilot: Can call Polyhedra tools
Test: test_quick.ps1 all pass
```
### β οΈ Needs Check
```
MCP output: No logs
Copilot: Can't see Polyhedra tools
Test: Some failures
```
**Fix**: Reload VS Code
### β Has Problems
```
MCP output: Error messages
Copilot: Tool call failures
Test: Failed
```
**Fix**: See `FIX_GUIDE.md`
---
## Next Steps
1. β
Ensure diagnostic passes: `.\test_quick.ps1`
2. π Reload VS Code
3. π Test in Copilot
4. π See `docs/USER_GUIDE.md` to learn more
|