tools

Building MCP servers from scratch:
- Repetitive boilerplate code
- Inconsistent tool interfaces
- Scattered tool implementations
- No shared utilities or patterns

MCP Tools Monorepo:
- Modular tool architecture 🧩
- Consistent interfaces across tools 🎯
- Shared core utilities 📦
- MCP adaptors for easy integration ⚡

# Clone the repository
git clone https://github.com/SylphxAI/tools.git
cd tools

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Build continuously during development
pnpm build:watch

# Run linting
pnpm lint

# Run tests (build first)
pnpm test

packages/
├── tools-{name}/          # Core tool logic
│   ├── src/
│   │   ├── index.ts       # Tool implementation
│   │   └── types.ts       # TypeScript types
│   └── package.json
└── tools-{name}-mcp/      # MCP server wrapper
    ├── src/
    │   └── index.ts       # MCP server entry
    └── package.json

import { defineTool } from '@sylphx/tools-core'

const myTool = defineTool({
  name: 'my-tool',
  description: 'Does something useful',
  schema: { /* Zod schema */ },
  execute: async (input) => { /* implementation */ }
})

import { createMCPServer } from '@sylphx/tools-adaptor-mcp'
import { myTool } from '@sylphx/tools-mytool'

const server = createMCPServer({
  tools: [myTool],
  name: 'My MCP Server',
  version: '1.0.0'
})

# Build all packages
pnpm build

# Build specific package
pnpm --filter @sylphx/tools-filesystem build

# Watch mode for development
pnpm build:watch

# Lint all packages
pnpm lint

# Fix linting issues
pnpm lint:fix

# Format code
pnpm format

# Run all tests
pnpm test

# Run tests for specific package
pnpm --filter @sylphx/tools-json test

# Watch mode
pnpm test:watch

# Create package directory
mkdir -p packages/tools-newtool/src

# Create package.json
cat > packages/tools-newtool/package.json  {
    // Implementation
    return { result: `Processed: ${input}` }
  }
})

# Create MCP package
mkdir -p packages/tools-newtool-mcp/src

# Create server
cat > packages/tools-newtool-mcp/src/index.ts 
  Modular. Reusable. Production-ready.
  
  The MCP toolkit that scales with your needs
  
   •
   •