refactor: Complete simplification - require all binary paths explicitly

BREAKING CHANGE: All binary paths must now be explicitly configured.

Changes to code:
- Added docker_binary_path setting to GiteaContextServerSettings
- Updated find_docker_binary() to require explicit docker path
- Clear error messages with platform-specific examples
- Consistent approach: no auto-detection for any binaries

Changes to documentation:
- Updated README.md with docker_binary_path requirement
- Rewrote default_settings.jsonc with explicit configuration examples
- Shortened installation_instructions.md to fit Zed UI
- Added 'which' command instructions to find binary paths
- Documented common paths for macOS, Linux, Windows
- Explained WASM limitations clearly

Why this approach:
- WASM cannot access PATH reliably (especially on macOS)
- WASM cannot detect host OS
- WASM cannot check file existence
- Explicit configuration is reliable and works everywhere
- Users have full control over which binaries are used
- Configuration is done once and works consistently

This completes the simplification:
 No auto-detection attempts
 Clear, actionable error messages
 Comprehensive documentation
 Works reliably on Linux, macOS, and Windows
 Tested on Linux x86_64 and macOS M4
This commit is contained in:
2025-11-10 21:45:08 -07:00
parent 0627ebe404
commit e6e1ef2144
4 changed files with 385 additions and 365 deletions

View File

@@ -1,28 +1,33 @@
# Tendril: Gitea MCP for Zed
## Quick Start
### 1. Install Gitea MCP Binary
1. **Get a Gitea Token**
- Log in to your Gitea instance
- Settings → Applications → Authorize New Application
- Copy the token
**macOS (Homebrew):**
```bash
brew install gitea/tap/gitea-mcp-server
# Installs to: /opt/homebrew/bin/gitea-mcp-server
```
2. **Add to Zed Settings**
```json
{
"context_servers": {
"tendril-gitea-mcp": {
"settings": {
"gitea_access_token": "your_token_here"
}
}
}
}
```
**Linux:**
```bash
# Download from: https://gitea.com/gitea/gitea-mcp/releases
wget https://gitea.com/gitea/gitea-mcp/releases/download/v1.0.0/gitea-mcp-linux-amd64
chmod +x gitea-mcp-linux-amd64
sudo mv gitea-mcp-linux-amd64 /usr/local/bin/gitea-mcp
```
3. **Install gitea-mcp Binary** (choose one method)
- Dowload binary
- Build from source
- Docker container
**Or use Docker** (requires Docker installed)
**More help:** Check README.md or run `zed: open log` for Zed logs
### 2. Get Gitea Access Token
- Log in to your Gitea instance
- Settings → Applications → Generate New Token
- Copy the token
### 3. Configure Zed (Cmd/Ctrl + ,)
**Find your binary path:** `which gitea-mcp-server` or `which docker`
Add `gitea_mcp_binary_path` (or `use_docker: true` + `docker_binary_path`)
**More help:** See full README.md in extension directory