Skip to content

Commit f3c6312

Browse files
committed
Readme update with Windows + Claude instruction
1 parent 6091119 commit f3c6312

1 file changed

Lines changed: 209 additions & 0 deletions

File tree

README.md

Lines changed: 209 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -224,6 +224,215 @@ After that you can explore the tools and resources with MCP Inspector at which i
224224

225225
Simply point your AI client (like Cursor, Windsurf, ClaudeDesktop, VS Code with Copilot, or [others](https://github.com/punkpeye/awesome-mcp-clients)) to use the appropriate configuration file from the repository.
226226

227+
## Platform-Specific Setup Guides
228+
229+
### Claude Desktop + gget_mcp Step-by-Step Guide (Windows)
230+
231+
<details>
232+
<summary>Comprehensive Windows setup guide with Google Drive integration</summary>
233+
234+
#### Overview
235+
This guide will walk you through setting up Claude Desktop with the gget_mcp extension and Google Drive integration on Windows. By the end, you'll be able to use Claude to fetch biological data (like gene sequences) and save them directly to your Google Drive folder with offline access.
236+
237+
#### Prerequisites
238+
- Windows PC with administrator access
239+
- Google account
240+
- Stable internet connection
241+
242+
#### Step 1: Set Up Google Drive for Desktop with Offline Access
243+
244+
1. Download and install [Google Drive for Desktop](https://www.google.com/drive/download/)
245+
2. Launch the application and sign in with your user account
246+
3. Connect your project's shared Google account (if applicable)
247+
4. **Configure offline access for your working folder:**
248+
- Navigate to the folder you want to work with in Google Drive
249+
- Right-click on the folder (e.g., "work" or your project folder)
250+
- Select **"Available offline"** from the context menu
251+
- This makes the folder accessible at a path like `C:\GDrive\holy-bio-mcp\My Disk\work`
252+
253+
**Important:** This is different from just syncing - offline access ensures the files are locally available while still being part of your Google Drive structure.
254+
255+
#### Step 2: Install Claude Desktop
256+
257+
1. Download [Claude Desktop](https://claude.ai/download) for Windows
258+
2. Run the installer and follow the setup wizard
259+
3. Sign in with your Anthropic/Claude account
260+
4. Complete the initial setup
261+
262+
#### Step 3: Install uv Package Manager
263+
264+
1. Install `uv` using one of these methods:
265+
266+
**Option A: Using winstall**
267+
- Visit [https://winstall.app/apps/astral-sh.uv](https://winstall.app/apps/astral-sh.uv)
268+
- Follow installation instructions
269+
270+
**Option B: Using PowerShell**
271+
```powershell
272+
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
273+
```
274+
275+
2. Restart your terminal after installation
276+
277+
#### Step 4: Install Node.js
278+
279+
You can install Node.js using either method:
280+
281+
**Option A: Native Installer**
282+
1. Visit [https://nodejs.org/en/download](https://nodejs.org/en/download)
283+
2. Download the Windows installer (LTS version recommended)
284+
3. Run the installer with default settings
285+
286+
**Option B: Using Chocolatey**
287+
```powershell
288+
choco install nodejs
289+
```
290+
291+
Both methods work equally well - choose whichever you prefer.
292+
293+
#### Step 5: Verify Installation & Cache Packages
294+
295+
Open Command Prompt or PowerShell and run:
296+
297+
```bash
298+
uvx --from gget-mcp@latest stdio
299+
```
300+
301+
**Expected behavior:**
302+
- The command should start without errors
303+
- Packages will be downloaded and cached
304+
- If it runs successfully, everything is configured correctly
305+
- You can press `Ctrl+C` to stop it
306+
307+
#### Step 6: Configure Claude Desktop
308+
309+
##### 6.1: Enable Filesystem Extension
310+
311+
1. Open Claude Desktop
312+
2. Go to **Settings** (gear icon)
313+
3. Navigate to the **"Extensions"** tab in the left sidebar
314+
4. Enable the **Filesystem** Extension
315+
5. Add your Google Drive offline folder to the allowed directories (e.g., `C:\GDrive\holy-bio-mcp\My Disk\work`)
316+
317+
**Note:** The Filesystem extension is built into Claude Desktop and uses MCP under the hood, but it's managed directly by the application. You don't need to configure it in the JSON file.
318+
319+
##### 6.2: Add gget_mcp Server
320+
321+
1. In the same manner, go to **Settings**, navigate to the **"Developer"** tab in the left sidebar
322+
2. In **Developer** settings tab, click **"Edit Config"** button
323+
3. This will open the `claude_desktop_config.json` file
324+
4. Edit it and add the gget_mcp server configuration:
325+
326+
```json
327+
{
328+
"mcpServers": {
329+
"gget": {
330+
"command": "uvx",
331+
"args": [
332+
"--from",
333+
"gget-mcp@latest",
334+
"stdio"
335+
]
336+
}
337+
}
338+
}
339+
```
340+
341+
5. Save the configuration file
342+
343+
#### Step 7: Restart Claude Desktop
344+
345+
1. Completely close Claude Desktop (check system tray)
346+
2. Restart the application
347+
3. **Note:** On first launch, you might experience a timeout - this is normal
348+
4. If needed, restart Claude Desktop a second time
349+
350+
#### Step 8: Verify Extensions Are Active
351+
352+
1. Open Claude Desktop Settings
353+
2. Go to the **Developer** tab
354+
3. Confirm that both components are enabled:
355+
-**Filesystem Extension** - should show your configured Google Drive path and show "Running" status
356+
-**gget MCP Server** - should show "Running" status
357+
358+
#### Step 9: Test the Setup
359+
360+
Now let's verify everything works! In Claude Desktop, create a new chat.
361+
Click "Search and tools" icon, select and enable both gget_mcp and filesystem
362+
363+
Try this prompt:
364+
365+
```text
366+
Please search for the COL1A1 gene, retrieve its protein sequence,
367+
and save it to C:\GDrive\holy-bio-mcp\My Disk\work\test_sequences\ as a FASTA file.
368+
```
369+
370+
**Expected result:**
371+
- Claude will use gget_mcp to search for the gene
372+
- It will fetch the sequence data
373+
- It will save the file to your specified folder
374+
- The file will sync to Google Drive automatically
375+
- Claude will be able to read it using Filesystem Extension.
376+
377+
#### Troubleshooting
378+
379+
##### MCP Server Not Connecting
380+
381+
- Ensure `uv` and `node` are in your system PATH
382+
- Try running the verification command again from Step 5
383+
- Restart Claude Desktop completely
384+
385+
##### Filesystem Permission Errors
386+
387+
- Check that the Filesystem Extension has access to your Google Drive folder
388+
- Verify the folder has offline access enabled in Google Drive
389+
- Try running Claude Desktop as administrator
390+
- Ensure the path is correct (use the exact path shown in File Explorer)
391+
392+
##### Timeout on First Launch
393+
394+
- This is normal - simply restart Claude Desktop
395+
- Wait 10-15 seconds before making requests
396+
397+
##### gget Commands Not Working
398+
399+
- Ensure internet connection is stable (gget fetches from online databases)
400+
- Check that the gget_mcp server shows as "Active" in settings
401+
- Try the verification command from Step 5 again
402+
403+
##### Google Drive Offline Access Issues
404+
405+
- Confirm the folder shows a green checkmark in Google Drive for Desktop
406+
- If files aren't syncing, right-click the folder and re-enable "Available offline"
407+
- Check that you have enough local disk space for offline files
408+
409+
#### Success! 🎉
410+
411+
If everything works correctly, you now have:
412+
- ✅ Claude Desktop with MCP capabilities
413+
- ✅ Access to biological databases via gget_mcp
414+
- ✅ Direct file operations in your Google Drive offline folder
415+
- ✅ Automatic cloud synchronization of all results
416+
417+
You can now ask Claude to fetch gene sequences, protein data, perform BLAST searches, and save everything directly to your Google Drive folder with offline access!
418+
419+
#### Example Use Cases
420+
421+
- **Fetch gene sequences:** "Get the DNA sequence for BRCA1 and save it to my Drive"
422+
- **Protein analysis:** "Find the protein sequence for TP53 and create a markdown report"
423+
- **Bulk operations:** "Search for all genes related to apoptosis and create a summary table"
424+
- **Cross-referencing:** "Get information about COL1A1 from Ensembl and UniProt"
425+
426+
#### Additional Resources
427+
428+
- [gget documentation](https://github.com/pachterlab/gget)
429+
- [Model Context Protocol docs](https://modelcontextprotocol.io/)
430+
- [Claude Desktop support](https://support.anthropic.com/)
431+
432+
*Guide updated: October 13, 2025*
433+
434+
</details>
435+
227436
## Repository setup
228437

229438
<details>

0 commit comments

Comments
 (0)