Skip to content

Commit edb965f

Browse files
ctothclaude
andcommitted
Remove MCP tool usage instructions from CLAUDE.md
Remove meta MCP tool usage examples and documentation that were confusing and unnecessary. CLAUDE.md should focus on development guidance, not tool usage instructions for AI assistants. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 7990afc commit edb965f

File tree

1 file changed

+1
-71
lines changed

1 file changed

+1
-71
lines changed

CLAUDE.md

Lines changed: 1 addition & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,7 @@ uv run mypy .
5555
## Version Management
5656

5757
- To bump the version use uv version --bump <patch|minor|major> commit (only the changes to pyproject.toml) push, and monitor the workflow run to verify it actually gets deployed.
58+
- **IMPORTANT**: The deployment workflow is triggered by git tags, not pushes. After pushing version changes, create and push a tag: `git tag v<version> && git push origin v<version>`
5859

5960
## Architecture Overview
6061

@@ -118,74 +119,3 @@ New languages require:
118119

119120
The system automatically detects language from file extensions and falls back gracefully for unsupported languages.
120121

121-
## MCP Tools Interface
122-
123-
The server exposes 5 tools to AI assistants:
124-
125-
1. **`get_symbols`** - Primary entry point for code discovery (uses modern core library)
126-
2. **`get_function`** - Extract specific functions (legacy tree traversal)
127-
3. **`get_class`** - Extract specific classes (legacy tree traversal)
128-
4. **`get_lines`** - Extract line ranges by number
129-
5. **`get_signature`** - Get function signatures only
130-
131-
**Best Practice**: Always use `get_symbols` first for code exploration, then use specific extraction tools for detailed analysis.
132-
133-
### URL Support
134-
135-
All 5 MCP tools support URLs for fetching remote code:
136-
137-
**Examples:**
138-
```python
139-
# GitHub raw URLs
140-
get_symbols("https://raw.githubusercontent.com/user/repo/main/src/main.py")
141-
get_function("https://raw.githubusercontent.com/user/repo/main/src/api.py", "handle_request")
142-
143-
# GitLab raw URLs
144-
get_class("https://gitlab.com/user/project/-/raw/main/src/models.py", "User")
145-
get_lines("https://gitlab.com/user/project/-/raw/main/config.py", 10, 20)
146-
147-
# Direct file URLs
148-
get_signature("https://example.com/code/utils.py", "helper_function")
149-
```
150-
151-
**Features:**
152-
- Automatic content-type validation (text/* only)
153-
- File size limits (1MB default, configurable)
154-
- TTL caching for performance (5min default)
155-
- Robust error handling for network issues
156-
- Support for GitHub, GitLab, and direct file URLs
157-
158-
### Git Revision Support
159-
160-
All 5 MCP tools also support an optional `git_revision` parameter for extracting code from any git revision:
161-
162-
**Examples:**
163-
```python
164-
# Extract from filesystem (default, backward compatible)
165-
get_symbols("src/main.py")
166-
get_function("src/main.py", "process_data")
167-
168-
# Extract from git revisions (NOT compatible with URLs)
169-
get_symbols("src/main.py", "HEAD~1") # Previous commit
170-
get_function("src/main.py", "process_data", "feature-branch") # Branch
171-
get_class("src/models.py", "User", "v1.0.0") # Tagged version
172-
get_lines("src/config.py", 10, 20, "abc123") # Specific commit hash
173-
174-
# Works with all git revision formats
175-
get_signature("src/api.py", "handle_request", "HEAD^2") # Merge parent
176-
```
177-
178-
**Supported Revision Formats:**
179-
- Commit hashes: `"abc123def"`, `"abc123def456789..."`
180-
- Branch names: `"main"`, `"feature-branch"`, `"develop"`
181-
- Tags: `"v1.0.0"`, `"release-2023-12"`
182-
- Relative refs: `"HEAD~1"`, `"HEAD^"`, `"HEAD~3"`
183-
- Any valid git revision that `git show` accepts
184-
185-
**Requirements:**
186-
- File must be in a git repository
187-
- Git command must be available in PATH
188-
- Revision must exist in the repository
189-
- File must exist at the specified revision
190-
- **Note**: `git_revision` parameter is NOT supported when using URLs
191-
```

0 commit comments

Comments
 (0)