Skip to main content
Glama

MCP Toolkit

by ydzat

MCP Toolkit

A modular MCP (Model Context Protocol) toolkit for building extensible tool services with ChromaDB-powered semantic search and intelligent data management.

✨ Features

  • 🔧 Modular Architecture: Support for dynamic service registration and hot-swappable components
  • 🌐 Standard MCP Protocol: Full support for MCP 2024-11-05 specification with n8n compatibility
  • 🛠️ Rich Tool Set: 54 tools including file operations, network requests, system management, intelligent code analysis, task management, memory system, visualization, Git integration, version management, agent automation, intelligent analysis, agent behavior control, deep context analysis, and semantic intelligence
  • 🧠 ChromaDB Integration: Unified vector database for semantic search and intelligent data storage
  • 🔍 Semantic Search: AI-powered search across files, web content, system information, code, tasks, and memories
  • 🤖 Context Engine: Multi-language code analysis with intelligent query processing and similarity search
  • 📋 Task Management: ChromaDB-based task storage with semantic search and specialized search tools
  • 🧠 Memory System: Knowledge accumulation, conversation history, and intelligent memory retrieval
  • 📊 Visualization Tools: Mermaid diagrams, Chart.js data visualization, and complex nested charts
  • 🔗 Tool Collaboration: Chain execution, parallel processing, and data flow management
  • 🚀 Lightweight & Efficient: Personal project focused on core functionality with enterprise-grade features

🎯 Current Status

Phase 3 Complete ✅ (July 2025)

  • 54 tools available (12 basic + 6 enhanced + 4 context engine + 4 Git integration + 3 version management + 2 agent automation + 3 intelligent analysis + 3 agent behavior + 3 deep context + 4 semantic intelligence + 4 task management + 1 memory + 4 visualization + 1 collaboration)
  • ChromaDB unified data storage across all intelligent tools
  • Multi-language code analysis (Python, JavaScript, TypeScript, etc.)
  • Task management system with semantic search and specialized search tools
  • Memory system for knowledge accumulation and intelligent retrieval
  • Visualization tools for Mermaid diagrams, data charts, and complex nested structures
  • Tool collaboration framework with chain execution and parallel processing
  • Intelligent semantic search and similarity matching across all data types
  • Natural language query processing
  • Full MCP protocol compatibility with n8n integration

Installation

# Clone the repository git clone https://github.com/yourusername/mcp-toolkit.git cd mcp-toolkit # Install with uv uv sync # Activate virtual environment source .venv/bin/activate

🚀 Quick Start

Basic Mode

# Run the basic MCP server mcp-toolkit --config config/development.yaml # Health check curl http://localhost:8080/health
# Run with ChromaDB and all intelligent tools ./scripts/run_mcp_daemon.sh # The server will automatically detect enhanced configuration # and start with all 32 tools including semantic search, code analysis, # task management, memory system, and visualization tools

n8n Integration

Server URL: http://your-server:8082 (SSE endpoint) Available Tools: 54 tools ready for use (including context engine, task management, memory system, visualization, agent automation, and semantic intelligence)

🛠️ Available Tools

Basic Tools (12)

CategoryToolDescription
File Systemread_fileRead file contents
write_fileWrite file contents
list_filesList directory files
create_directoryCreate directories
Networkhttp_requestHTTP requests
dns_lookupDNS queries
Searchfile_searchFile name search
content_searchFile content search
Systemrun_commandExecute commands
get_environmentGet environment variables
set_working_directorySet working directory
UtilityechoEcho test tool

Enhanced Tools (6) 🧠

CategoryToolDescription
Smart File Systemenhanced_read_fileRead files + ChromaDB storage + metadata
search_filesSemantic file search
Smart Networkenhanced_fetch_webFetch web pages + ChromaDB storage
search_web_contentSemantic web content search
Smart Systemget_system_infoSystem info + ChromaDB storage
manage_processesProcess management

Context Engine Tools (4) 🤖

CategoryToolDescription
Code Analysisanalyze_codeMulti-language code analysis + ChromaDB storage
Intelligent Searchsearch_codeNatural language code search
find_similar_codeSemantic similarity code search
Project Analysisget_project_overviewProject statistics and overview

Git Integration Tools (4) 🔄

CategoryToolDescription
Diff Analysisgit_diff_analysisSmart Git diff analysis with multi-level insights
Patch Managementgit_apply_patchPrecise patch application with line-level editing
History Analysisgit_history_analysisGit history and change tracking analysis
Conflict Detectiongit_conflict_checkPotential merge conflict detection and analysis

Version Management Tools (3) ⏱️

CategoryToolDescription
Operation Trackingundo_operationUndo agent operations with fine-grained control
Checkpoint Managementrollback_to_checkpointRollback to specific checkpoints or time points
Checkpoint Controlmanage_checkpointCreate, list, delete and manage version checkpoints

Agent Automation Tools (2) 🤖

CategoryToolDescription
Task Decompositiondecompose_taskDecompose complex tasks into subtasks
Execution Guidanceget_execution_guidanceTask execution guidance and suggestions

Intelligent Analysis Tools (3) 📈

CategoryToolDescription
Code Qualityanalyze_code_qualityCode quality analysis and improvement suggestions
Performance Monitoringmonitor_performanceSystem performance metrics monitoring
History Trendsanalyze_history_trendsHistorical data trend analysis

Agent Behavior Tools (3) 🎯

CategoryToolDescription
State Controlcontrol_agent_stateAgent state machine control
Behavior Validationvalidate_agent_behaviorBehavior consistency validation
Learning Optimizationoptimize_agent_learningHistory-based learning optimization

Deep Context Engine Tools (3) 🔍

CategoryToolDescription
Dependency Analysisanalyze_dependenciesCode dependency relationship analysis
Call Graphbuild_call_graphFunction call relationship graph construction
Refactoring Suggestionssuggest_refactoringCode refactoring suggestions

Semantic Intelligence Tools (4) 💡

CategoryToolDescription
Semantic Understandingunderstand_semanticsBusiness logic and design pattern understanding
Code Completionget_code_completionsIntelligent code completion suggestions
Pattern Recognitionrecognize_patternsDesign pattern and programming pattern recognition
Best Practicesget_best_practicesBest practice suggestions

Task Management Tools (4) 📋

CategoryToolDescription
Task Managementmanage_tasksTask creation, update, delete, query + ChromaDB storage
Specialized Searchsearch_recent_tasksSearch recently created tasks
search_tasks_by_timeSearch tasks by time range
search_tasks_semanticSemantic task search by content

Memory Management Tools (1) 🧠

CategoryToolDescription
Memory Systemmanage_memoryKnowledge storage, retrieval, search (knowledge, conversation, experience, skills)

Visualization Tools (4) 📊

CategoryToolDescription
Chart Generationgenerate_diagramMermaid diagrams (flowcharts, sequence, mind maps)
create_data_chartData visualization (Chart.js format)
Complex Chartsgenerate_subgraph_diagramComplex nested subgraph diagrams
generate_state_machineState machine and automaton diagrams

Tool Collaboration (1) 🔗

CategoryToolDescription
Workflow Executionexecute_tool_chainChain execution, parallel processing, data flow

Core Features

  • ChromaDB Unified Storage: All intelligent tools share a unified vector database for seamless data integration
  • Multi-Language Code Analysis: Support for Python, JavaScript, TypeScript, and more
  • Intelligent Query Processing: Natural language understanding with intent parsing
  • Semantic Search: AI-powered search using sentence-transformers across files, code, tasks, and memories
  • Code Understanding: Function/class analysis, similarity matching, project overview
  • Task Management: ChromaDB-based task storage with specialized search tools and semantic search
  • Memory System: Knowledge accumulation, conversation history, and intelligent memory retrieval
  • Visualization Capabilities: Mermaid diagrams, Chart.js data visualization, complex nested charts
  • Tool Collaboration: Chain execution, parallel processing, and data flow management
  • Agent Automation: Complex task decomposition and intelligent execution guidance
  • Intelligent Analysis: Code quality analysis, performance monitoring, and history trend analysis
  • Agent Behavior Control: State machine control, behavior validation, and learning optimization
  • Deep Context Analysis: Code dependency analysis, call graph construction, and refactoring suggestions
  • Semantic Intelligence: Business logic understanding, intelligent code completion, and pattern recognition
  • Intelligent Metadata: Automatic language detection, content analysis, complexity scoring
  • MCP Compatible: Full protocol compliance for seamless integration with n8n and other clients

📋 Configuration

Enhanced Mode Configuration

Create config/enhanced_tools_config.yaml:

# ChromaDB Configuration chromadb: persist_directory: "./mcp_unified_db" embedding_model: "sentence-transformers/all-MiniLM-L6-v2" # Enhanced Tools Settings enhanced_file_operations: max_file_size_mb: 10 auto_store_to_chromadb: true enhanced_network: timeout: 30 max_content_size_mb: 5 auto_store_to_chromadb: true enhanced_system: auto_store_to_chromadb: true

🔧 Development

This project follows a milestone-based development approach:

  • Phase 1 ✅: Basic tools + ChromaDB integration (Complete)
  • Phase 2 ✅: Context engine + Multi-language code analysis (Complete)
  • Phase 3 ✅: Task management + Memory system + Visualization + Tool collaboration (Complete)
  • Phase 4 📋: Advanced features + Performance optimization (Planned)

See doc/basic_tools/README.md for detailed design documentation.

📊 Project Stats

  • Total Tools: 54 (12 basic + 6 enhanced + 4 context engine + 4 Git integration + 3 version management + 2 agent automation + 3 intelligent analysis + 3 agent behavior + 3 deep context + 4 semantic intelligence + 4 task management + 1 memory + 4 visualization + 1 collaboration)
  • Code Analysis: Multi-language support (Python, JavaScript, TypeScript, etc.)
  • Task Management: ChromaDB-based with semantic search and specialized search tools
  • Memory System: Knowledge accumulation with intelligent retrieval
  • Visualization: Mermaid diagrams, Chart.js data visualization, complex nested charts
  • Tool Collaboration: Chain execution, parallel processing, data flow management
  • Agent Automation: Task decomposition and execution guidance
  • Intelligent Analysis: Code quality, performance monitoring, history trends
  • Agent Behavior: State control, behavior validation, learning optimization
  • Deep Context: Dependency analysis, call graphs, refactoring suggestions
  • Semantic Intelligence: Business logic understanding, code completion, pattern recognition
  • Database: ChromaDB with sentence-transformers for unified vector storage
  • Protocol: MCP 2024-11-05 compliant
  • Integration: n8n compatible via SSE
  • Language: Python 3.12+
  • Test Coverage: Full integration testing with n8n, all tools verified
  • Dependencies: aiohttp, chromadb, sentence-transformers, beautifulsoup4, psutil

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

📄 License

AGPL-3.0 License - see LICENSE for details

Related MCP Servers

  • -
    security
    A
    license
    -
    quality
    A dynamic MCP server implementation that automatically loads tools, resources, and prompts from their respective directories, allowing for easy extension and configuration.
    Last updated -
    Python
    MIT License
  • -
    security
    A
    license
    -
    quality
    A powerful executable server for running Model Context Protocol services that supports tool chain execution, multiple MCP services management, and a pluggable tool system for complex automation workflows.
    Last updated -
    6
    60
    TypeScript
    MIT License
    • Apple
  • -
    security
    F
    license
    -
    quality
    An MCP server that allows users to create custom tools on the fly by stitching together actions from multiple MCP tools into reusable routines.
    Last updated -
    21
    1
    TypeScript
  • -
    security
    F
    license
    -
    quality
    A modular and extensible tool server built on FastMCP that supports multiple tools organized across files and communicates via MCP protocol.
    Last updated -
    Python

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ydzat/dnkit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server