torbjorn/my-pal-mcp-server
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: reorder tools with chat as first tool

Browse Source 
- Move chat to position #1 as the most general and approachable tool
- Reorder all tool sections accordingly
- Update all anchor links and cross-references
- Update 'Why This Server' section to prioritize chat
- Better flow from general (chat) to specialized tools
This commit is contained in:
Fahad
2025-06-09 14:08:59 +04:00
parent 854dbe16cf
commit c5ac7a08df
1 changed files with 54 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files

108
README.md
View File

@@ -11,13 +11,13 @@ The ultimate development partner for Claude - a Model Context Protocol server th
## Why This Server? ## Why This Server?
Claude is brilliant, but sometimes you need: Claude is brilliant, but sometimes you need:
- **A second opinion** on complex architectural decisions - augment Claude's extended thinking with Gemini's perspective ([`think_deeper`](#1-think_deeper---extended-reasoning-partner)) - **A senior developer partner** to validate and extend ideas ([`chat`](#1-chat---general-development-chat--collaborative-thinking))
- **Massive context window** (1M tokens) - Gemini 2.5 Pro can analyze entire codebases, read hundreds of files at once, and provide comprehensive insights ([`analyze`](#5-analyze---smart-file-analysis)) - **A second opinion** on complex architectural decisions - augment Claude's extended thinking with Gemini's perspective ([`think_deeper`](#2-think_deeper---extended-reasoning-partner))
- **Deep code analysis** across massive codebases that exceed Claude's context limits ([`analyze`](#5-analyze---smart-file-analysis)) - **Professional code reviews** with actionable feedback across entire repositories ([`review_code`](#3-review_code---professional-code-review))
- **Expert debugging** for tricky issues with full system context ([`debug_issue`](#4-debug_issue---expert-debugging-assistant)) - **Pre-commit validation** with deep analysis that finds edge cases, validates your implementation against original requirements, and catches subtle bugs Claude might miss ([`review_pending_changes`](#4-review_pending_changes---pre-commit-validation))
- **Professional code reviews** with actionable feedback across entire repositories ([`review_code`](#2-review_code---professional-code-review)) - **Expert debugging** for tricky issues with full system context ([`debug_issue`](#5-debug_issue---expert-debugging-assistant))
- **Pre-commit validation** with deep analysis that finds edge cases, validates your implementation against original requirements, and catches subtle bugs Claude might miss ([`review_pending_changes`](#3-review_pending_changes---pre-commit-validation)) - **Massive context window** (1M tokens) - Gemini 2.5 Pro can analyze entire codebases, read hundreds of files at once, and provide comprehensive insights ([`analyze`](#6-analyze---smart-file-analysis))
- **A senior developer partner** to validate and extend ideas ([`chat`](#6-chat---general-development-chat--collaborative-thinking)) - **Deep code analysis** across massive codebases that exceed Claude's context limits ([`analyze`](#6-analyze---smart-file-analysis))
- **Dynamic collaboration** - Gemini can request additional context from Claude mid-analysis for more thorough insights - **Dynamic collaboration** - Gemini can request additional context from Claude mid-analysis for more thorough insights
This server makes Gemini your development sidekick, handling what Claude can't or extending what Claude starts. This server makes Gemini your development sidekick, handling what Claude can't or extending what Claude starts.
@@ -126,16 +126,52 @@ Just ask Claude naturally:
- **Server info?** → `get_version` (version and configuration details) - **Server info?** → `get_version` (version and configuration details)
**Tools Overview:** **Tools Overview:**
1. [`think_deeper`](#1-think_deeper---extended-reasoning-partner) - Extended reasoning and problem-solving 1. [`chat`](#1-chat---general-development-chat--collaborative-thinking) - Collaborative thinking and development conversations
2. [`review_code`](#2-review_code---professional-code-review) - Professional code review with severity levels 2. [`think_deeper`](#2-think_deeper---extended-reasoning-partner) - Extended reasoning and problem-solving
3. [`review_pending_changes`](#3-review_pending_changes---pre-commit-validation) - Validate git changes before committing 3. [`review_code`](#3-review_code---professional-code-review) - Professional code review with severity levels
4. [`debug_issue`](#4-debug_issue---expert-debugging-assistant) - Root cause analysis and debugging 4. [`review_pending_changes`](#4-review_pending_changes---pre-commit-validation) - Validate git changes before committing
5. [`analyze`](#5-analyze---smart-file-analysis) - General-purpose file and code analysis 5. [`debug_issue`](#5-debug_issue---expert-debugging-assistant) - Root cause analysis and debugging
6. [`chat`](#6-chat---general-development-chat--collaborative-thinking) - Collaborative thinking and development conversations 6. [`analyze`](#6-analyze---smart-file-analysis) - General-purpose file and code analysis
7. [`list_models`](#7-list_models---see-available-gemini-models) - List available Gemini models 7. [`list_models`](#7-list_models---see-available-gemini-models) - List available Gemini models
8. [`get_version`](#8-get_version---server-information) - Get server version and configuration 8. [`get_version`](#8-get_version---server-information) - Get server version and configuration
### 1. `think_deeper` - Extended Reasoning Partner ### 1. `chat` - General Development Chat & Collaborative Thinking
**Your thinking partner - bounce ideas, get second opinions, brainstorm collaboratively**
#### Example Prompts:
**Basic Usage:**
```
"Use gemini to explain how async/await works in Python"
"Get gemini to compare Redis vs Memcached for session storage"
"Share my authentication design with gemini and get their opinion"
"Brainstorm with gemini about scaling strategies for our API"
```
**Collaborative Workflow:**
```
"Research the best message queue for our use case (high throughput, exactly-once delivery).
Use gemini to compare RabbitMQ, Kafka, and AWS SQS. Based on gemini's analysis and your research,
recommend the best option with implementation plan."
"Design a caching strategy for our API. Get gemini's input on Redis vs Memcached vs in-memory caching.
Combine both perspectives to create a comprehensive caching implementation guide."
```
**Key Features:**
- Collaborative thinking partner for your analysis and planning
- Get second opinions on your designs and approaches
- Brainstorm solutions and explore alternatives together
- Validate your checklists and implementation plans
- General development questions and explanations
- Technology comparisons and best practices
- Architecture and design discussions
- Can reference files for context: `"Use gemini to explain this algorithm with context from algorithm.py"`
- **Dynamic collaboration**: Gemini can request additional files or context during the conversation if needed for a more thorough response
**Triggers:** ask, explain, compare, suggest, what about, brainstorm, discuss, share my thinking, get opinion
### 2. `think_deeper` - Extended Reasoning Partner
<div align="center"> <div align="center">
<img src="https://github.com/user-attachments/assets/0f3c8e2d-a236-4068-a80e-46f37b0c9d35" width="600"> <img src="https://github.com/user-attachments/assets/0f3c8e2d-a236-4068-a80e-46f37b0c9d35" width="600">
@@ -179,7 +215,7 @@ about event ordering and failure scenarios. Then integrate gemini's insights and
**Triggers:** think deeper, ultrathink, extend my analysis, validate my approach **Triggers:** think deeper, ultrathink, extend my analysis, validate my approach
### 2. `review_code` - Professional Code Review ### 3. `review_code` - Professional Code Review
**Comprehensive code analysis with prioritized feedback** **Comprehensive code analysis with prioritized feedback**
#### Example Prompts: #### Example Prompts:
@@ -208,7 +244,7 @@ make any necessary adjustments and show me the final secure implementation."
**Triggers:** review code, check for issues, find bugs, security check **Triggers:** review code, check for issues, find bugs, security check
### 3. `review_pending_changes` - Pre-Commit Validation ### 4. `review_pending_changes` - Pre-Commit Validation
**Comprehensive review of staged/unstaged git changes across multiple repositories** **Comprehensive review of staged/unstaged git changes across multiple repositories**
#### Example Prompts: #### Example Prompts:
@@ -249,7 +285,7 @@ implementations or missing test coverage. Update the code based on gemini's find
**Triggers:** review pending changes, check my changes, validate changes, pre-commit review **Triggers:** review pending changes, check my changes, validate changes, pre-commit review
### 4. `debug_issue` - Expert Debugging Assistant ### 5. `debug_issue` - Expert Debugging Assistant
**Root cause analysis for complex problems** **Root cause analysis for complex problems**
#### Example Prompts: #### Example Prompts:
@@ -281,7 +317,7 @@ suggest preventive measures."
**Triggers:** debug, error, failing, root cause, trace, not working **Triggers:** debug, error, failing, root cause, trace, not working
### 5. `analyze` - Smart File Analysis ### 6. `analyze` - Smart File Analysis
**General-purpose code understanding and exploration** **General-purpose code understanding and exploration**
#### Example Prompts: #### Example Prompts:
@@ -310,42 +346,6 @@ Combine your findings with gemini's to create a comprehensive security report."
**Triggers:** analyze, examine, look at, understand, inspect **Triggers:** analyze, examine, look at, understand, inspect
### 6. `chat` - General Development Chat & Collaborative Thinking
**Your thinking partner - bounce ideas, get second opinions, brainstorm collaboratively**
#### Example Prompts:
**Basic Usage:**
```
"Use gemini to explain how async/await works in Python"
"Get gemini to compare Redis vs Memcached for session storage"
"Share my authentication design with gemini and get their opinion"
"Brainstorm with gemini about scaling strategies for our API"
```
**Collaborative Workflow:**
```
"Research the best message queue for our use case (high throughput, exactly-once delivery).
Use gemini to compare RabbitMQ, Kafka, and AWS SQS. Based on gemini's analysis and your research,
recommend the best option with implementation plan."
"Design a caching strategy for our API. Get gemini's input on Redis vs Memcached vs in-memory caching.
Combine both perspectives to create a comprehensive caching implementation guide."
```
**Key Features:**
- Collaborative thinking partner for your analysis and planning
- Get second opinions on your designs and approaches
- Brainstorm solutions and explore alternatives together
- Validate your checklists and implementation plans
- General development questions and explanations
- Technology comparisons and best practices
- Architecture and design discussions
- Can reference files for context: `"Use gemini to explain this algorithm with context from algorithm.py"`
- **Dynamic collaboration**: Gemini can request additional files or context during the conversation if needed for a more thorough response
**Triggers:** ask, explain, compare, suggest, what about, brainstorm, discuss, share my thinking, get opinion
### 7. `list_models` - See Available Gemini Models ### 7. `list_models` - See Available Gemini Models
``` ```
"Use gemini to list available models" "Use gemini to list available models"