Japanese Text Analyzer

Instructions

Implementation Reference

• src/index.ts:204-265 (handler)

  Core handler implementation for counting words in text. Handles English (space-separated) and Japanese (using kuromoji tokenizer for morphemes, excluding symbols and spaces). Returns formatted result or error.

  private async countTextWordsImpl(text: string, language: 'en' | 'ja' = 'en', sourceName: string = 'テキスト') {
    try {
      let wordCount = 0;
      let resultText = '';
      
      if (language === 'en') {
        // 英語の場合、単語はスペースで区切られているためsplitで分割
        const words = text.trim().split(/\s+/);
        wordCount = words.length;
        resultText = `${sourceName}の単語数: ${wordCount}単語 (英語モード)`;
      } else if (language === 'ja') {
        // 日本語の場合、kuromojiを使用して形態素解析
        // 形態素解析器が利用可能かを確認
        let tokenizer;
        
        try {
          tokenizer = await initializeTokenizer();
        } catch (error) {
          return {
            content: [{ 
              type: 'text' as const, 
              text: '形態素解析器の初期化に失敗しました。しばらく待ってから再試行してください。'
            }],
            isError: true
          };
        }
        
        // 形態素解析を実行
        const tokens = tokenizer.tokenize(text);
        
        // 記号と空白以外のすべての単語をカウント（助詞や助動詞も含める）
        const meaningfulTokens = tokens.filter((token: any) => {
          // 記号と空白のみを除外
          return !(token.pos === '記号' || token.pos === '空白');
        });
        
        wordCount = meaningfulTokens.length;
        
        // 単語の詳細情報を出力
        const tokenDetails = tokens.map((token: any) => {
          return `【${token.surface_form}】 品詞: ${token.pos}, 品詞細分類: ${token.pos_detail_1}, 読み: ${token.reading}`;
        }).join('\n');
        
        resultText = `${sourceName}の単語数: ${wordCount}単語 (日本語モード、すべての品詞を含む)\n\n分析結果:\n${tokenDetails}\n\n有効な単語としてカウントしたもの:\n${meaningfulTokens.map((t: any) => t.surface_form).join(', ')}`;
      }
      
      return {
        content: [{ 
          type: 'text' as const, 
          text: resultText
        }]
      };
    } catch (error: any) {
      return {
        content: [{ 
          type: 'text' as const, 
          text: `エラーが発生しました: ${error.message}`
        }],
        isError: true
      };
    }
  }

• src/index.ts:498-501 (schema)

  Zod schema defining input parameters for the count_words tool: filePath (string) and optional language (en|ja, default en).

  { 
    filePath: z.string().describe('単語数をカウントするファイルのパス（Windows形式かWSL/Linux形式の絶対パスを推奨）'),
    language: z.enum(['en', 'ja']).default('en').describe('ファイルの言語 (en: 英語, ja: 日本語)')
  },

• src/index.ts:495-518 (registration)

  MCP tool registration for 'count_words': specifies name, Japanese description, Zod schema, and inline async handler that resolves file path, reads content, and delegates to countTextWordsImpl.

  this.server.tool(
    'count_words', 
    'ファイルの単語数を計測します。絶対パスを指定してください（Windows形式 C:\\Users\\...、またはWSL/Linux形式 /c/Users/... のどちらも可）。英語ではスペースで区切られた単語をカウントし、日本語では形態素解析を使用します。',
    { 
      filePath: z.string().describe('単語数をカウントするファイルのパス（Windows形式かWSL/Linux形式の絶対パスを推奨）'),
      language: z.enum(['en', 'ja']).default('en').describe('ファイルの言語 (en: 英語, ja: 日本語)')
    },
    async ({ filePath, language }) => {
      try {
        // ファイルパスを解決
        const resolvedPath = resolveFilePath(filePath);
        const fileContent = fs.readFileSync(resolvedPath, 'utf8');
        return await this.countTextWordsImpl(fileContent, language, `ファイル '${resolvedPath}'`);
      } catch (error: any) {
        return {
          content: [{ 
            type: 'text' as const, 
            text: `ファイル読み込みエラー: ${error.message}`
          }],
          isError: true
        };
      }
    }
  );

• src/index.ts:125-149 (helper)

  Helper function to resolve file paths, handling absolute paths, WSL to Windows conversion, and relative paths.

  function resolveFilePath(filePath: string): string {
    try {
      // WSL/Linux形式のパス (/c/Users/...) をWindows形式 (C:\Users\...) に変換
      if (filePath.match(/^\/[a-zA-Z]\//)) {
        // /c/Users/... 形式を C:\Users\... 形式に変換
        const drive = filePath.charAt(1).toUpperCase();
        let windowsPath = `${drive}:${filePath.substring(2).replace(/\//g, '\\')}`;
        
        console.error(`WSL/Linux形式のパスをWindows形式に変換: ${filePath} -> ${windowsPath}`);
        
        if (fs.existsSync(windowsPath)) {
          console.error(`変換されたパスでファイルを発見: ${windowsPath}`);
          return windowsPath;
        }
      }
      
      // 通常の絶対パスの処理
      if (path.isAbsolute(filePath)) {
        if (fs.existsSync(filePath)) {
          console.error(`絶対パスでファイルを発見: ${filePath}`);
          return filePath;
        }
        
        // 絶対パスでファイルが見つからない場合はエラー
        throw new Error(`指定された絶対パス "${filePath}" が存在しません。パスが正しいか確認してください。` +