Commit 9ccafed

mo khan <mo@mokhan.ca>
2025-07-02 17:57:52
docs: add claude mcp add instructions to all MCP server help text
- Added "ADDING TO CLAUDE CODE" section to all 10 MCP server help outputs - Includes practical examples of claude mcp add commands for each server - Covers various configuration scenarios (default, custom paths, environment variables) - Improves discoverability and ease of integration with Claude Code CLI 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 5e921f5
Changed files (10)
cmd
fetch
filesystem
git
gitlab
imap
maildir
memory
sequential-thinking
signal
time
cmd/fetch/main.go
@@ -29,6 +29,10 @@ EXAMPLE USAGE:
     # Test with MCP protocol
     echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "fetch", "arguments": {"url": "https://example.com"}}}' | mcp-fetch
 
+ADDING TO CLAUDE CODE:
+    # Add to Claude Code (no configuration needed)
+    claude mcp add mcp-fetch -- /usr/local/bin/mcp-fetch
+
 MCP CAPABILITIES:
     - Tools: fetch (web content retrieval with HTML processing)
     - Features: goquery HTML parsing, html-to-markdown conversion
cmd/filesystem/main.go
@@ -34,6 +34,16 @@ EXAMPLE USAGE:
     # Test with MCP protocol
     echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | mcp-filesystem --allowed-directory /tmp
 
+ADDING TO CLAUDE CODE:
+    # Add to Claude Code for single directory
+    claude mcp add mcp-filesystem -- /usr/local/bin/mcp-filesystem --allowed-directory /tmp
+
+    # Add to Claude Code for multiple directories
+    claude mcp add mcp-filesystem -- /usr/local/bin/mcp-filesystem --allowed-directory /tmp,/home/user/projects
+
+    # Add to Claude Code for current project directory
+    claude mcp add mcp-filesystem -- /usr/local/bin/mcp-filesystem --allowed-directory $(pwd)
+
 MCP CAPABILITIES:
     - Tools: read_file, write_file, list_directory, create_directory, move_file, search_files, and more
     - Resources: file:// URIs for directories and files
cmd/git/main.go
@@ -34,6 +34,16 @@ EXAMPLE USAGE:
     # Test with MCP protocol
     echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | mcp-git
 
+ADDING TO CLAUDE CODE:
+    # Add to Claude Code for current directory
+    claude mcp add mcp-git -- /usr/local/bin/mcp-git --repository $(pwd)
+
+    # Add to Claude Code for specific repository
+    claude mcp add mcp-git -- /usr/local/bin/mcp-git --repository /path/to/repo
+
+    # Add to Claude Code (minimal, uses current directory)
+    claude mcp add mcp-git -- /usr/local/bin/mcp-git
+
 MCP CAPABILITIES:
     - Tools: git_status, git_diff, git_commit, git_add, git_log, git_create_branch, git_checkout, and more
     - Resources: git:// URIs for files, branches, and commits
cmd/gitlab/main.go
@@ -40,6 +40,16 @@ Examples:
   # Use with self-hosted GitLab instance
   mcp-gitlab --gitlab-url https://gitlab.company.com
 
+Adding to Claude Code:
+  # Add to Claude Code (using environment variable, recommended)
+  claude mcp add mcp-gitlab -- /usr/local/bin/mcp-gitlab
+
+  # Add to Claude Code with token directly
+  claude mcp add mcp-gitlab -- /usr/local/bin/mcp-gitlab --gitlab-token your_token_here
+
+  # Add to Claude Code for self-hosted GitLab
+  claude mcp add mcp-gitlab -- /usr/local/bin/mcp-gitlab --gitlab-url https://gitlab.company.com --gitlab-token your_token
+
 Tools:
   - gitlab_list_my_projects: List projects you have access to with activity info
   - gitlab_list_my_issues: Issues assigned/authored/mentioned, prioritized by activity
cmd/imap/main.go
@@ -85,6 +85,13 @@ func main() {
 		fmt.Println("  imap_delete_message uid=12345 confirmed=true")
 		fmt.Println("  imap_delete_messages uids=[12345,12346] confirmed=true")
 		fmt.Println()
+		fmt.Println("ADDING TO CLAUDE CODE:")
+		fmt.Println("  # Add with command-line arguments")
+		fmt.Println("  claude mcp add mcp-imap -- /usr/local/bin/mcp-imap --server imap.gmail.com --username user@gmail.com --password app-password")
+		fmt.Println()
+		fmt.Println("  # Add for Migadu")
+		fmt.Println("  claude mcp add mcp-imap -- /usr/local/bin/mcp-imap --server mail.migadu.com --username user@domain.com --password password")
+		fmt.Println()
 		fmt.Println("CLAUDE CODE CONFIGURATION:")
 		fmt.Println("  # Recommended: Use environment variables for security")
 		fmt.Println("  {")
cmd/maildir/main.go
@@ -34,6 +34,16 @@ EXAMPLE USAGE:
     # Test with MCP protocol
     echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "maildir_scan_folders", "arguments": {"maildir_path": "~/.local/share/mail"}}}' | mcp-maildir --maildir-path ~/.local/share/mail
 
+ADDING TO CLAUDE CODE:
+    # Add to Claude Code for single mailbox
+    claude mcp add mcp-maildir -- /usr/local/bin/mcp-maildir --maildir-path ~/.local/share/mail
+
+    # Add to Claude Code for multiple mailboxes
+    claude mcp add mcp-maildir -- /usr/local/bin/mcp-maildir --maildir-path ~/.local/share/mail/personal,~/.local/share/mail/work
+
+    # Add to Claude Code for standard mail directory
+    claude mcp add mcp-maildir -- /usr/local/bin/mcp-maildir --maildir-path ~/.local/share/mail/personal
+
 MCP CAPABILITIES:
     - Tools: maildir_scan_folders, maildir_list_messages, maildir_read_message, maildir_search_messages, maildir_get_thread, maildir_analyze_contacts, maildir_get_statistics
     - Resources: maildir:// URIs for email folder access
cmd/memory/main.go
@@ -38,6 +38,16 @@ EXAMPLE USAGE:
     # Test with MCP protocol
     echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "read_graph", "arguments": {}}}' | mcp-memory
 
+ADDING TO CLAUDE CODE:
+    # Add to Claude Code with default memory file
+    claude mcp add mcp-memory -- /usr/local/bin/mcp-memory
+
+    # Add to Claude Code with custom memory file
+    claude mcp add mcp-memory -- /usr/local/bin/mcp-memory --memory-file /path/to/knowledge.json
+
+    # Add to Claude Code with project-specific memory
+    claude mcp add mcp-memory -- /usr/local/bin/mcp-memory --memory-file $(pwd)/.memory.json
+
 MCP CAPABILITIES:
     - Tools: create_entities, create_relations, read_graph, search_nodes, add_observations, and more
     - Resources: memory:// URIs for knowledge graph access
cmd/sequential-thinking/main.go
@@ -33,6 +33,16 @@ EXAMPLE USAGE:
     # Test with MCP protocol
     echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "sequentialthinking", "arguments": {"task": "Analyze the problem step by step"}}}' | mcp-sequential-thinking
 
+ADDING TO CLAUDE CODE:
+    # Add to Claude Code (no session persistence)
+    claude mcp add mcp-sequential-thinking -- /usr/local/bin/mcp-sequential-thinking
+
+    # Add to Claude Code with session persistence
+    claude mcp add mcp-sequential-thinking -- /usr/local/bin/mcp-sequential-thinking --session-file /tmp/thinking_sessions.json
+
+    # Add to Claude Code with project-specific sessions
+    claude mcp add mcp-sequential-thinking -- /usr/local/bin/mcp-sequential-thinking --session-file $(pwd)/.thinking_sessions.json
+
 MCP CAPABILITIES:
     - Tools: sequentialthinking (structured reasoning workflows)
     - Features: Step-by-step problem decomposition, logical reasoning chains
cmd/signal/main.go
@@ -35,6 +35,16 @@ Examples:
   # Specify custom Signal path
   mcp-signal --signal-path ~/.config/Signal
 
+Adding to Claude Code:
+  # Add to Claude Code (auto-detect Signal installation)
+  claude mcp add mcp-signal -- /usr/local/bin/mcp-signal
+
+  # Add to Claude Code with custom Signal path
+  claude mcp add mcp-signal -- /usr/local/bin/mcp-signal --signal-path ~/.config/Signal
+
+  # Add to Claude Code for macOS (typical path)
+  claude mcp add mcp-signal -- /usr/local/bin/mcp-signal --signal-path ~/Library/Application\\ Support/Signal
+
 Tools:
   - signal_list_conversations: List all conversations
   - signal_search_messages: Search messages by text content
cmd/time/main.go
@@ -29,6 +29,10 @@ EXAMPLE USAGE:
     # Test with MCP protocol
     echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_current_time", "arguments": {}}}' | mcp-time
 
+ADDING TO CLAUDE CODE:
+    # Add to Claude Code (no configuration needed)
+    claude mcp add mcp-time -- /usr/local/bin/mcp-time
+
 MCP CAPABILITIES:
     - Tools: get_current_time, convert_time
     - Features: Time zone conversions, date formatting, temporal calculations