MCP Servers

A collection of Model Context Protocol (MCP) servers for personal use, built with TypeScript and the FastMCP framework.

Overview

This project provides MCP servers that can be used with AI assistants and other applications that support the Model Context Protocol. Currently includes tools for token counting and text analysis.

Features

Tiktoken Tool

• Token Counting: Determine the number of tokens in text using the js-tiktoken library
• Uses the o200k_base encoding (GPT-4 tokenizer)
• Useful for managing token limits in AI applications

Claude Desktop Integration

This package is designed to work with Claude Desktop's MCP Server configuration. You can use it directly with npx without needing to install it locally.

Quick Setup

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "berrydev-mcp-servers": {
      "command": "npx",
      "args": [
        "-y",
        "@berrydev-ai/mcp-servers"
      ],
      "env": {}
    }
  }
}

After adding this configuration, restart Claude Desktop. The tiktoken tool will be available for token counting operations.

Installation

npm install

Publishing to NPM

This package is configured to be published to NPM for use with npx. The package includes:

• Executable binary configuration
• Automatic builds before publishing
• Proper file inclusion for distribution

npm publish

Development

Build the project

npm run build

Development mode (watch)

npm run dev

Run the server

npm start

Inspect with MCP Inspector

npm run inspector

Inspect with FastMCP CLI

npm run mcp-cli

Testing

Run tests:

npm test

Code Quality

Type checking

npm run type-check

Linting

npm run lint
npm run lint:fix  # Auto-fix issues

Formatting

npm run format        # Format code
npm run format:check  # Check formatting

Run all checks

npm run check

Project Structure

src/
├── index.ts          # Main server entry point
└── tools/
    ├── tiktoken.ts   # Token counting tool
    └── tiktoken.spec.ts # Tests for tiktoken tool

Available Tools

tiktoken

Counts tokens in the provided text using the GPT-4 tokenizer.

Parameters:

• text (string): The text to analyze (minimum 1 character)

Returns:

• Token count as a number

Example usage in Claude Desktop: Once configured, you can ask Claude to count tokens in text, and it will automatically use this tool.

Direct API usage:

{
  "name": "tiktoken",
  "arguments": {
    "text": "Hello, world!"
  }
}

CI/CD

The project includes GitHub Actions workflows for:

• Continuous Integration: Runs tests, linting, and type checking on Node.js 18.x and 20.x
• NPM Publishing: Automated publishing to NPM and GitHub Packages

Configuration

TypeScript

• Target: ES2022
• Module: NodeNext (for proper ES module support)
• Strict mode enabled
• Source maps and declarations generated

Dependencies

• Runtime: fastmcp, js-tiktoken, zod
• Development: TypeScript, ESLint, Prettier, Vitest

License

MIT

Author

Eric Berry ([email protected])