{"_id":"@berrydev-ai/mcp-servers","name":"@berrydev-ai/mcp-servers","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@berrydev-ai/mcp-servers","type":"module","version":"1.0.0","description":"Collection of MCP servers for personal use","main":"dist/index.js","bin":{"mcp-servers":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/berrydev-ai/mcp-servers.git"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","mcp-cli":"npx fastmcp inspect src/index.ts","test":"vitest run","lint":"eslint src/**/*.ts","lint:fix":"eslint src/**/*.ts --fix","format":"prettier --write src/**/*.ts","format:check":"prettier --check src/**/*.ts","type-check":"tsc --noEmit","check":"npm run type-check && npm run lint && npm run format:check","prepublishOnly":"npm run build","prepack":"npm run build"},"author":{"name":"Eric Berry","url":"eric@berrydev.ai"},"license":"MIT","dependencies":{"fastmcp":"^3.10.0","js-tiktoken":"^1.0.20","zod":"^4.0.8"},"devDependencies":{"@eslint/js":"^9.31.0","@types/node":"^24.1.0","@typescript-eslint/eslint-plugin":"^8.38.0","@typescript-eslint/parser":"^8.38.0","eslint":"^9.31.0","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.3","prettier":"^3.6.2","typescript":"^5.8.3","vitest":"^3.2.4"},"_id":"@berrydev-ai/mcp-servers@1.0.0","gitHead":"b3ae853cc3a9925780ea100ae5f5f54b7dc68399","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/berrydev-ai/mcp-servers/issues"},"homepage":"https://github.com/berrydev-ai/mcp-servers#readme","_nodeVersion":"20.19.3","_npmVersion":"10.8.2","dist":{"integrity":"sha512-kTSYtnWxFGG3cvcgfupzwTWMDtqrAzYAUsJsCJ1dkjfgzh7gL5ciedjZ0q3PEJ4TCnH62Qx5SQbugIeLhZnW6w==","shasum":"c780382084371fc2d2c403a4ff6b26d7fcf70c76","tarball":"https://registry.npmjs.org/@berrydev-ai/mcp-servers/-/mcp-servers-1.0.0.tgz","fileCount":14,"unpackedSize":10513,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDtVH5WjCfM1cYooDy409iGhDB5VMW3Plt4Ux7omxBJCQIgKfuQeO8eB8MRg70RpKlTM/pyg1ubmH/ICDOBEtKFD5s="}]},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"directories":{},"maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-servers_1.0.0_1753369599452_0.04270327883710734"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-24T15:06:39.344Z","1.0.0":"2025-07-24T15:06:39.655Z","modified":"2025-07-24T15:06:40.020Z"},"maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"description":"Collection of MCP servers for personal use","homepage":"https://github.com/berrydev-ai/mcp-servers#readme","repository":{"type":"git","url":"git+https://github.com/berrydev-ai/mcp-servers.git"},"author":{"name":"Eric Berry","url":"eric@berrydev.ai"},"bugs":{"url":"https://github.com/berrydev-ai/mcp-servers/issues"},"license":"MIT","readme":"# MCP Servers\n\nA collection of Model Context Protocol (MCP) servers for personal use, built with TypeScript and the [FastMCP](https://github.com/jlowin/fastmcp) framework.\n\n## Overview\n\nThis 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.\n\n## Features\n\n### Tiktoken Tool\n- **Token Counting**: Determine the number of tokens in text using the `js-tiktoken` library\n- Uses the `o200k_base` encoding (GPT-4 tokenizer)\n- Useful for managing token limits in AI applications\n\n## Claude Desktop Integration\n\nThis 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.\n\n### Quick Setup\n\nAdd the following to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"berrydev-mcp-servers\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@berrydev-ai/mcp-servers\"\n      ],\n      \"env\": {}\n    }\n  }\n}\n```\n\nAfter adding this configuration, restart Claude Desktop. The tiktoken tool will be available for token counting operations.\n\n## Installation\n\n```bash\nnpm install\n```\n\n### Publishing to NPM\n\nThis package is configured to be published to NPM for use with `npx`. The package includes:\n- Executable binary configuration\n- Automatic builds before publishing\n- Proper file inclusion for distribution\n\n```bash\nnpm publish\n```\n\n## Development\n\n### Build the project\n```bash\nnpm run build\n```\n\n### Development mode (watch)\n```bash\nnpm run dev\n```\n\n### Run the server\n```bash\nnpm start\n```\n\n### Inspect with MCP Inspector\n```bash\nnpm run inspector\n```\n\n### Inspect with FastMCP CLI\n```bash\nnpm run mcp-cli\n```\n\n## Testing\n\nRun tests:\n```bash\nnpm test\n```\n\n## Code Quality\n\n### Type checking\n```bash\nnpm run type-check\n```\n\n### Linting\n```bash\nnpm run lint\nnpm run lint:fix  # Auto-fix issues\n```\n\n### Formatting\n```bash\nnpm run format        # Format code\nnpm run format:check  # Check formatting\n```\n\n### Run all checks\n```bash\nnpm run check\n```\n\n## Project Structure\n\n```\nsrc/\n├── index.ts          # Main server entry point\n└── tools/\n    ├── tiktoken.ts   # Token counting tool\n    └── tiktoken.spec.ts # Tests for tiktoken tool\n```\n\n## Available Tools\n\n### `tiktoken`\nCounts tokens in the provided text using the GPT-4 tokenizer.\n\n**Parameters:**\n- `text` (string): The text to analyze (minimum 1 character)\n\n**Returns:**\n- Token count as a number\n\n**Example usage in Claude Desktop:**\nOnce configured, you can ask Claude to count tokens in text, and it will automatically use this tool.\n\n**Direct API usage:**\n```json\n{\n  \"name\": \"tiktoken\",\n  \"arguments\": {\n    \"text\": \"Hello, world!\"\n  }\n}\n```\n\n## CI/CD\n\nThe project includes GitHub Actions workflows for:\n- **Continuous Integration**: Runs tests, linting, and type checking on Node.js 18.x and 20.x\n- **NPM Publishing**: Automated publishing to NPM and GitHub Packages\n\n## Configuration\n\n### TypeScript\n- Target: ES2022\n- Module: NodeNext (for proper ES module support)\n- Strict mode enabled\n- Source maps and declarations generated\n\n### Dependencies\n- **Runtime**: `fastmcp`, `js-tiktoken`, `zod`\n- **Development**: TypeScript, ESLint, Prettier, Vitest\n\n## License\n\nMIT\n\n## Author\n\nEric Berry (eric@berrydev.ai)","readmeFilename":"README.md","_rev":"1-11c73f45a235a8a372618459e7c63dee"}