MCP Enhancements

Author: Shashikant86

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Superagentic AI
+Copyright (c) 2025 Superagentic AI
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

docs/advanced/mcp-integration.md

@@ -126,6 +126,22 @@ Create a module that searches the web and summarizes results
 
 DSPy Code generates code with MCP integration!
 
+---
+
+## 🧪 Real-World MCP Recipes
+
+Looking for concrete, copy-pasteable workflows? Start with these:
+
+- 📂 **Project Files Assistant (Filesystem MCP)**  
+  Turn your local project into a browsable, explainable knowledge base.  
+  See: [MCP Filesystem Assistant](../tutorials/mcp-filesystem-assistant.md)
+
+- 🐙 **GitHub Triage Copilot (GitHub MCP)**  
+  Pull issues/PRs via MCP and generate a morning triage summary.  
+  See: [MCP GitHub Triage Copilot](../tutorials/mcp-github-triage.md)
+
+---
+
 ## MCP Server Types
 
 ### 1. stdio Transport

docs/reference/commands.md

@@ -239,7 +239,7 @@ Add an MCP server configuration.
 
 **Examples:**
 ```
-/mcp-add filesystem --transport stdio --command uvx --args mcp-server-filesystem
+/mcp-add filesystem --transport stdio --command npx --args -y "@modelcontextprotocol/server-filesystem" /path/to/directory
 /mcp-add github --transport sse --url https://api.github.com/mcp
 ```
 

docs/reference/configuration.md

@@ -41,12 +41,14 @@ models:
 mcp_servers:
   - name: filesystem
     transport: stdio
-    command: uvx
+    command: npx
     args:
-      - mcp-server-filesystem
+      - -y
+      - "@modelcontextprotocol/server-filesystem"
+      - /path/to/root
     env:
-      - name: MCP_SERVER_FILESYSTEM_ROOT
-        value: /path/to/root
+      - name: NODE_ENV
+        value: production
 
 rag:
   enabled: true
@@ -197,12 +199,14 @@ List of MCP server configurations.
 ```yaml
 - name: filesystem
   transport: stdio
-  command: uvx
+  command: npx
   args:
-    - mcp-server-filesystem
+    - -y
+    - "@modelcontextprotocol/server-filesystem"
+    - /path/to/root
   env:
-    - name: MCP_SERVER_FILESYSTEM_ROOT
-      value: /path/to/root
+    - name: NODE_ENV
+      value: production
 ```
 
 #### sse (Server-Sent Events)

dspy_code/commands/config_command.py

@@ -29,7 +29,7 @@ def show_config(verbose: bool = False) -> None:
     config_manager = ConfigManager()
     if not config_manager.is_project_initialized():
         console.print("[red]Error:[/red] Not in a DSPy project directory.")
-        console.print("Run 'dspy-cli init' to initialize a new project.")
+        console.print("Run 'dspy-code init' to initialize a new project.")
         return
 
     try:
@@ -150,7 +150,7 @@ def reset_config(skip_confirmation: bool = False, verbose: bool = False) -> None
     config_manager = ConfigManager()
     if not config_manager.is_project_initialized():
         console.print("[red]Error:[/red] Not in a DSPy project directory.")
-        console.print("Run 'dspy-cli init' to initialize a new project.")
+        console.print("Run 'dspy-code init' to initialize a new project.")
         return
 
     try:
@@ -184,7 +184,7 @@ def reset_config(skip_confirmation: bool = False, verbose: bool = False) -> None
             "   Edit dspy_config.yaml or run '/connect <provider> <model>' in interactive mode"
         )
         console.print("\n2. View configuration:")
-        console.print("   [cyan]dspy-cli config show[/cyan]")
+        console.print("   [cyan]dspy-code config show[/cyan]")
 
     except Exception as e:
         logger.error(f"Failed to reset configuration: {e}")

dspy_code/commands/create_command.py

@@ -48,7 +48,7 @@ def execute(
     config_manager = ConfigManager()
     if not config_manager.is_project_initialized():
         console.print("[red]Error:[/red] No dspy_config.yaml found in current directory.")
-        console.print("Run 'dspy-cli init' to create a configuration file.")
+        console.print("Run 'dspy-code init' to create a configuration file.")
         return
 
     try:
@@ -245,10 +245,10 @@ def _show_next_steps(output_file: Path) -> None:
     """Show next steps to the user."""
     console.print("\n[bold]Next Steps:[/bold]")
     console.print("1. Test your component:")
-    console.print(f"   [cyan]dspy-cli run {output_file} --interactive[/cyan]")
+    console.print(f"   [cyan]dspy-code run {output_file} --interactive[/cyan]")
     console.print("\n2. Optimize performance:")
-    console.print(f"   [cyan]dspy-cli optimize {output_file}[/cyan]")
+    console.print(f"   [cyan]dspy-code optimize {output_file}[/cyan]")
     console.print("\n3. Export for sharing:")
-    console.print(f"   [cyan]dspy-cli export {output_file}[/cyan]")
+    console.print(f"   [cyan]dspy-code export {output_file}[/cyan]")
     console.print("\n4. View the generated code:")
     console.print(f"   [cyan]cat {output_file}[/cyan]")

dspy_code/commands/export_command.py

@@ -44,7 +44,7 @@ def execute(
     config_manager = ConfigManager()
     if not config_manager.is_project_initialized():
         console.print("[red]Error:[/red] No dspy_config.yaml found in current directory.")
-        console.print("Run 'dspy-cli init' to create a configuration file.")
+        console.print("Run 'dspy-code init' to create a configuration file.")
         return
 
     try:
@@ -105,10 +105,10 @@ def _export_as_json(
     # Create export data
     export_data = {
         "export_info": {
-            "format": "dspy-cli-json",
+            "format": "dspy-code-json",
             "version": "1.0",
             "exported_at": datetime.now().isoformat(),
-            "exported_by": "dspy-cli",
+            "exported_by": "dspy-code",
         },
         "component": {
             "name": component_file.stem,
@@ -312,7 +312,7 @@ def _create_export_readme(
 
 This component was created using DSPy Code, a command-line interface for the DSPy framework.
 
-- Learn more: https://github.com/dspy-cli/dspy-cli
+- Learn more: https://github.com/dspy-code/dspy-code
 - DSPy Documentation: https://dspy-docs.vercel.app/
 
 ## Export Information
@@ -346,7 +346,7 @@ def _show_sharing_instructions(output_file: Path, export_format: str) -> None:
     if export_format == "json":
         console.print("1. Share the JSON file with others")
         console.print("2. Recipients can import with:")
-        console.print("   [cyan]dspy-cli import component.json[/cyan]")
+        console.print("   [cyan]dspy-code import component.json[/cyan]")
     else:
         console.print("1. Share the ZIP file with others")
         console.print("2. Recipients can extract and use:")

dspy_code/commands/init_command.py

@@ -119,7 +119,7 @@ def _create_minimal_project(
     Create a minimal DSPy project with only the configuration file.
 
     This is the default initialization mode that creates only what's necessary
-    to start using dspy-cli. Additional directories will be created on-demand
+    to start using dspy-code. Additional directories will be created on-demand
     when commands need them.
 
     Args:
@@ -314,17 +314,17 @@ def _create_example_files(project_dir: Path) -> None:
 
 1. Create your first DSPy component:
    ```bash
-   dspy-cli create
+   dspy-code create
    ```
 
 2. Test your component:
    ```bash
-   dspy-cli run generated/your_program.py --interactive
+   dspy-code run generated/your_program.py --interactive
    ```
 
 3. Optimize your component:
    ```bash
-   dspy-cli optimize generated/your_program.py
+   dspy-code optimize generated/your_program.py
    ```
 
 ## Project Structure
@@ -343,7 +343,7 @@ def _create_example_files(project_dir: Path) -> None:
 ## Learn More
 
 - [DSPy Documentation](https://dspy-docs.vercel.app/)
-- [DSPy Code Guide](https://github.com/dspy-cli/dspy-cli)
+- [DSPy Code Guide](https://github.com/dspy-code/dspy-code)
 """
 
     (project_dir / "README.md").write_text(readme_content)
@@ -534,10 +534,10 @@ def _show_next_steps(project_name: str, fresh: bool = False) -> None:
     console.print("   [dim]See dspy_config_example.yaml for all available options[/dim]")
 
     console.print("\n2. Create your first DSPy component:")
-    console.print("   [cyan]dspy-cli create[/cyan]")
+    console.print("   [cyan]dspy-code create[/cyan]")
 
     console.print("\n3. Test model connectivity:")
-    console.print("   [cyan]dspy-cli models test <model-name>[/cyan]")
+    console.print("   [cyan]dspy-code models test <model-name>[/cyan]")
 
     if fresh:
         console.print("\n4. Explore the project structure:")
@@ -547,4 +547,4 @@ def _show_next_steps(project_name: str, fresh: bool = False) -> None:
         console.print("   - generated/ - DSPy Code generated components")
 
     console.print("\n4. Learn more:" if not fresh else "\n5. Learn more:")
-    console.print("   [cyan]dspy-cli --help[/cyan]")
+    console.print("   [cyan]dspy-code --help[/cyan]")

dspy_code/commands/mcp_command.py

@@ -132,8 +132,8 @@ async def add_server_async(
 
         console.print(f"[green]✓[/green] Server '{name}' added successfully")
         console.print("\nNext steps:")
-        console.print(f"  1. Connect to the server: [cyan]dspy-cli mcp connect {name}[/cyan]")
-        console.print(f"  2. List available tools: [cyan]dspy-cli mcp tools {name}[/cyan]")
+        console.print(f"  1. Connect to the server: [cyan]dspy-code mcp connect {name}[/cyan]")
+        console.print(f"  2. List available tools: [cyan]dspy-code mcp tools {name}[/cyan]")
 
     except MCPError as e:
         console.print(f"[red]{format_mcp_error(e, verbose)}[/red]")
@@ -180,7 +180,7 @@ async def list_servers_async(verbose: bool) -> None:
 
         if not servers:
             console.print("[yellow]No MCP servers configured[/yellow]")
-            console.print("\nAdd a server with: [cyan]dspy-cli mcp add[/cyan]")
+            console.print("\nAdd a server with: [cyan]dspy-code mcp add[/cyan]")
             return
 
         display_server_table(servers)
@@ -228,7 +228,7 @@ async def connect_server_async(name: str, verbose: bool) -> None:
             if caps.get("prompts"):
                 console.print("  • Prompts")
 
-        console.print(f"\nTry: [cyan]dspy-cli mcp tools {name}[/cyan]")
+        console.print(f"\nTry: [cyan]dspy-code mcp tools {name}[/cyan]")
 
     except MCPError as e:
         console.print(f"[red]{format_mcp_error(e, verbose)}[/red]")

dspy_code/commands/models_command.py

@@ -54,7 +54,7 @@ def list_models(verbose: bool = False) -> None:
     config_manager = ConfigManager()
     if not config_manager.is_project_initialized():
         console.print("[red]Error:[/red] Not in a DSPy project directory.")
-        console.print("Run 'dspy-cli init' to initialize a new project.")
+        console.print("Run 'dspy-code init' to initialize a new project.")
         return
 
     try:
@@ -126,7 +126,7 @@ def test_model(model_name: str, verbose: bool = False) -> None:
     config_manager = ConfigManager()
     if not config_manager.is_project_initialized():
         console.print("[red]Error:[/red] Not in a DSPy project directory.")
-        console.print("Run 'dspy-cli init' to initialize a new project.")
+        console.print("Run 'dspy-code init' to initialize a new project.")
         return
 
     try:
@@ -170,7 +170,7 @@ def set_default_model(model_name: str, verbose: bool = False) -> None:
     config_manager = ConfigManager()
     if not config_manager.is_project_initialized():
         console.print("[red]Error:[/red] Not in a DSPy project directory.")
-        console.print("Run 'dspy-cli init' to initialize a new project.")
+        console.print("Run 'dspy-code init' to initialize a new project.")
         return
 
     try: