MCP Tools Server

A comprehensive TypeScript-based local server that provides a unified, secure interface for AI assistants to interact with 50+ system tools, cloud services, and development utilities. Built on the Model Context Protocol (MCP), this project emphasizes security, permissions management, and local-first operations.

Features

• 🔒 Security-First Architecture: Granular permission controls and security policies for all tool operations
• 🛠️ 50+ Tools: Comprehensive tool suite spanning development, cloud, media, and system operations
• 🚀 Local Server: Local execution with minimal external dependencies
• 📦 TypeScript: Full type safety with strict mode enabled
• ✅ 100% Test Coverage: Comprehensive test suite with full coverage requirement
• 🔌 Extensible: Modular architecture for easy addition of new tools

Installation

# Global installation
npm install -g @mcp-tools/server

# Local installation
npm install @mcp-tools/server

# Development installation
npm install --save-dev @mcp-tools/server

Quick Start

# Clone the repository
git clone <repository-url>
cd mcp-tools

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Start the server
npm start

Development

Prerequisites

• Node.js (v18 or higher)
• TypeScript (v5.0 or higher)
• npm or pnpm

Development Commands

# Build TypeScript
npm run build

# Watch mode
npm run build:watch

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Format code
npm run format

# Run validation suite
npm run validate

Project Structure

mcp-tools/
├── src/
│   ├── server/          # MCP server implementation
│   ├── registry/        # Tool registry and discovery
│   ├── security/        # Security and permissions
│   ├── tools/           # Tool adapters (organized by category)
│   ├── types/           # TypeScript type definitions
│   ├── utils/           # Shared utilities
│   └── config/          # Configuration management
├── tests/
│   ├── unit/            # Unit tests
│   ├── integration/     # Integration tests
│   └── fixtures/        # Test fixtures and mocks
├── dist/                # Compiled output
└── .github/
    └── workflows/       # GitHub Actions CI/CD

Tool Categories

Development & Version Control

• git, github, npm, scaffold, make

Cloud Platforms & Infrastructure

• aws, gcp, terraform, docker

Data & Analytics

• database, dbt, schema, chart

Media & Content

• image editing, video processing, ffmpeg

System & Utilities

• files, backup, calculator, time

Web & Automation

• browser, playwright, fetch

Communication

• email, slack

AI & Cognitive

• sequential_thinking, debug, deep_view

Security

The project implements:

• Granular Permissions: Fine-grained access control for each tool operation
• Permission Validation: Runtime checks before executing any tool operation
• Audit Logging: Comprehensive logging of all tool invocations
• Sandboxing: Isolation of tool execution to prevent unauthorized system access
• Credential Management: Secure handling of API keys, tokens, and sensitive credentials

Testing

100% test coverage is required. All tests must pass before committing.

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Run unit tests only
npm run test:unit

# Run integration tests only
npm run test:integration

Contributing

1. Create a feature branch
2. Make your changes
3. Ensure 100% test coverage
4. Run validation suite: npm run validate
5. Create a pull request

See Development Workflow for detailed guidelines.

License

MIT

References

This project draws inspiration from the awesome-mcp-servers repository.