令牌计数器服务器

【技术文档摘要】

创建一个感知令牌的系统来管理LLM的上下文窗口是一种优化多代理工作流程的复杂方法。它准确地识别了当前AI驱动开发系统中的关键瓶颈。

这是一个基于TypeScript的MCP服务器，提供了一个用于计算文件和目录中令牌数量的工具。

安装

要开始使用，请先克隆仓库并从源代码构建服务器。

第一步：克隆和构建

1. 将仓库克隆到本地机器：

   git clone https://github.com/intro0siddiqui/token-counter-server.git
   

2. 进入该目录：

   cd token-counter-server
   

3. 安装依赖项并构建项目：

   npm install
   npm run build
   

完成这一步后，服务器就可以使用了。现在可以配置您的MCP客户端（如Claude Desktop）以使用它。

第二步：配置您的客户端

您有两种配置客户端的方法：

选项A：使用完整路径（简单）

您可以直接将客户端指向已构建的服务器文件。这是最简单的方法，不需要任何全局系统更改。

在您的claude_desktop_config.json中，使用刚刚克隆的目录内build/index.js的完整路径。

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "token-counter-server": {
      "command": "/path/to/your/cloned/repo/token-counter-server/build/index.js"
    }
  }
}

记得将/path/to/your/cloned/repo替换为您系统上的实际绝对路径。

选项B：使命令全局可用（高级）

如果您希望使用简单的token-counter-server命令而不必键入完整路径，可以将服务器作为全局命令进行安装。

重要提示：在运行此命令之前，您必须位于克隆的token-counter-server目录内。

1. 从本地源全局安装：

   npm install -g .
   

   此命令会在您的系统上创建一个指向服务器可执行文件的符号链接。

2. 使用简单命令配置您的客户端： 现在可以在客户端配置中使用token-counter-server：

   {
     "mcpServers": {
       "token-counter-server": {
         "command": "token-counter-server"
       }
     }
   }
   

包含的工具

此服务器提供了以下工具：

• count_tokens：计算文件或目录中的令牌数量。
  • path（字符串，必需）：文件或目录的路径。
  • file_pattern（字符串，可选）：用于过滤文件的glob模式（例如，*.ts）。

示例提示

这里是一些示例提示，您可以使用它们：

• 计算单个文件中的令牌数：

  "你能计算src/index.ts中的令牌吗？"

• 计算具有过滤器的目录中的令牌数：

  "在src目录中有多少令牌，只计算.ts文件？"

您可以在prompts/目录中找到这些和其他示例。

资源

此MCP包含用于测试和演示目的的样本文件。

• resources/sample.txt：一个用于测试令牌计数的样本文本文件。

开发

• 安装依赖项：npm install
• 构建：npm run build
• 监视更改：npm run watch

调试

要调试服务器，可以使用MCP Inspector：

npm run inspector

这将提供一个基于浏览器的界面，用于检查客户端与服务器之间的通信。