AI导哈

MCP服务器工具集

基于TypeScript和FastMCP框架构建的MCP服务器集合，提供令牌计数和文本分析功能，适用于AI助手等支持模型上下文协议的应用。

  • by berrydev-ai
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 berrydev-ai/mcp-servers

使用说明

MCP服务器

一组供个人使用的模型上下文协议（MCP）服务器，使用TypeScript和 FastMCP 框架。

概述

该项目提供可与AI助手和支持模型上下文协议的其他应用程序一起使用的MCP服务器。目前包括用于令牌计数和文本分析的工具。

特性

Tiktoken工具

  • 令牌计数：使用以下公式确定文本中的标记数量 js-tiktoken 图书馆
  • 使用 o200k_base 编码（GPT-4标记器）
  • 可用于管理AI应用程序中的令牌限制

Claude桌面集成

此软件包旨在与Claude Desktop的MCP服务器配置配合使用。您可以直接将其与npx一起使用，而无需在本地安装。

快速设置

将以下内容添加到您的Claude Desktop配置文件中：

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

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

添加此配置后，重新启动Claude Desktop。tiktoken工具将可用于令牌计数操作。

安装

npm install

向NPM发布

此软件包配置为发布到NPM以供使用 npx。该套餐包括：

  • 可执行二进制配置
  • 发布前自动生成
  • 正确包含文件以供分发
npm publish

发展

构建项目

npm run build

开发模式（手表）

npm run dev

运行服务器

npm start

与MCP检查员一起检查

npm run inspector

使用FastMCP CLI进行检查

npm run mcp-cli

测试

运行测试：

npm test

代码质量

类型检查

npm run type-check

掉毛

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

格式化

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

运行所有检查

npm run check

项目结构

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

可用工具

tiktoken

使用GPT-4标记器计算所提供文本中的标记。

参数：

  • text （string）：要分析的文本（至少1个字符）

退货：

  • 令牌计数为数字

Claude Desktop中的示例用法： 配置后，您可以要求Claude计算文本中的令牌，它将自动使用此工具。

API的直接使用：

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

CI/CD

该项目包括GitHub Actions工作流，用于：

  • 持续集成：在Node.js 18.x和20.x上运行测试、linting和类型检查
  • NPM出版：自动发布到NPM和GitHub包

配置

TypeScript

  • 目标：ES2022
  • 模块：NodeNext（用于适当的ES模块支持）
  • 严格模式已启用
  • 生成的源映射和声明

依赖项

  • 运行时: fastmcp, js-tiktoken, zod
  • 发展：TypeScript、ESLint、Prettier、Vitest

许可证

麻省理工学院

作者

埃里克·贝里(eric@berrydev.ai)

相关 MCP