mcp4mcp 0.1.28

Meta MCP Server for MCP development intelligence

mcp4mcp

Meta MCP Server - AI-powered development assistant for building better MCP projects

mcp4mcp automatically tracks your MCP tools, detects duplicates, suggests improvements, and provides AI-powered guidance throughout your development process.

🚀 Quick Start

# Install
pip install fastmcp
git clone https://github.com/your-org/mcp4mcp.git
cd mcp4mcp && pip install -e .

# Start server
python server.py

# Try the demo
python main.py demo

💡 What You Get

• 🧠 AI suggestions for next development steps
• 🔍 Duplicate detection before you build conflicting tools
• 📊 Progress tracking across development sessions
• 🔄 Auto-discovery of tools in your codebase
• 📈 Analytics on your development patterns

🛠️ Core Tools

Tool	Purpose
get_project_state_tool	Load your current project and tools
update_project_state_tool	Add/update tools and project info
scan_project_files_tool	Auto-discover tools in your code
check_before_build_tool	Check for conflicts before building
suggest_next_action_tool	Get AI-powered development suggestions
analyze_tool_similarity_tool	Find similar/duplicate tools
track_development_session_tool	Log your development activities
get_session_analytics_tool	View development insights

📋 Usage Examples

Start Development Session

# Log what you're working on
await track_development_session(
    "Building file processing tools", 
    "my_project",
    "csv_reader"
)

Check Before Building

# Avoid duplicates
result = await check_before_build(
    "file_processor", 
    "Process CSV files",
    "my_project" 
)

if result['conflicts']:
    print("⚠️ Similar tools exist - consider reusing instead")

Get AI Suggestions

# Get personalized guidance
suggestions = await suggest_next_action(
    "my_project",
    "Just finished the CSV reader, what's next?"
)

for suggestion in suggestions['suggestions']:
    print(f"💡 {suggestion}")

Auto-Discover Tools

# Scan your codebase
result = await scan_project_files("my_project", "./src")
print(f"🔍 Found {result['new_tools']} new tools")

🤖 AI-Powered MCP Development

Use this prompt template with any LLM to build MCP servers that leverage mcp4mcp:

# MCP Server Development with mcp4mcp

You are an expert MCP (Model Context Protocol) developer building a new MCP server. 
You have access to mcp4mcp tools that provide intelligent development assistance.

## Your Development Process:

1. **Start Each Session**: Always begin by calling `track_development_session_tool` 
   to log what you're working on

2. **Before Building Any Tool**: Call `check_before_build_tool` to check for 
   conflicts and similar existing tools

3. **Get AI Guidance**: Use `suggest_next_action_tool` for personalized 
   development recommendations based on project state

4. **Update Progress**: Use `update_project_state_tool` to track tools as you 
   build them (planned → in_progress → completed)

5. **Discover Existing Tools**: Use `scan_project_files_tool` to automatically 
   find tools in the codebase

6. **Check for Duplicates**: Run `analyze_tool_similarity_tool` periodically 
   to find similar tools that could be consolidated

## Current Task:
Build a [DOMAIN] MCP server with tools for [SPECIFIC_FUNCTIONALITY].

## Project Details:
- Project name: [PROJECT_NAME]
- Description: [PROJECT_DESCRIPTION] 
- Key requirements: [LIST_REQUIREMENTS]

Start by calling the appropriate mcp4mcp tools to understand the current state 
and get AI-powered suggestions for the best approach.

Example Prompt Usage:

# MCP Server Development with mcp4mcp

You are an expert MCP developer building a new MCP server. You have access to mcp4mcp tools.

## Current Task:
Build a file processing MCP server with tools for reading, writing, and transforming CSV/JSON files.

## Project Details:
- Project name: file-processor-mcp
- Description: MCP server for file operations with data transformation capabilities
- Key requirements: 
  * Read CSV and JSON files
  * Write data in multiple formats  
  * Transform data between formats
  * Validate file schemas
  * Handle large files efficiently

Start by calling mcp4mcp tools to check current state and get development guidance.

🔧 Integration

Add mcp4mcp to any FastMCP project:

from fastmcp import FastMCP
from mcp4mcp.tools.state_management import register_state_tools
from mcp4mcp.tools.intelligence import register_intelligence_tools  
from mcp4mcp.tools.tracking import register_tracking_tools

# Your MCP server
mcp = FastMCP("your-server")

# Add mcp4mcp intelligence
register_state_tools(mcp)
register_intelligence_tools(mcp) 
register_tracking_tools(mcp)

# Your tools
@mcp.tool()
def your_tool():
    return "Hello World"

mcp.run()

📊 Development Analytics

View your development patterns:

# Get insights on your development
analytics = await get_session_analytics("my_project", days=7)

print(f"📈 This week:")
print(f"  Sessions: {analytics['total_sessions']}")  
print(f"  Time: {analytics['total_development_time']}")
print(f"  Tools: {len(analytics['tools_worked_on'])}")

🗃️ Data Storage

All data stored locally in ~/.mcp4mcp/projects.db - no external dependencies.

🧪 Testing

# Run demo
python main.py demo

# Run tests  
python main.py test

# FastMCP diagnostics
python run_diagnostic.py

🛠️ Development

# Setup
git clone https://github.com/your-org/mcp4mcp.git
cd mcp4mcp
pip install -e ".[dev]"

# Test
python -m pytest tests/ -v

📄 License

This is free and unencumbered software released into the public domain. See the UNLICENSE file for details.

🤝 Support

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📚 Examples: See examples/ directory

---

mcp4mcp - Intelligence for MCP development 🧠✨