agentmods.dev

mcp-server-debug-thinking: Instructions file for Claude Code

CLAUDE.md

mcp-server-debug-thinking CLAUDE.md is an instructions file for Claude Code from tosssssy/mcp-server-debug-thinking. It costs 1,173 tokens per session, scanned A, original, MIT.

Repository instructions for a graph-based debugging MCP server. The server records problems, hypotheses, experiments, observations, lessons, solutions, and their relationships in JSONL files, a text format with one JSON object per line.

In plain words
What is it for?
Use them when working on this TypeScript debugging server, including its `debug_thinking` tool, graph storage, graph actions, and development commands.
Why use it?
They tell a coding agent how to build, develop, clean, lint, format, and understand the server's debugging data model.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions Claude Code.

This is tosssssy/mcp-server-debug-thinking's own configuration. It tells Claude Code how to work on mcp-server-debug-thinking itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything mcp-server-debug-thinking configures →

not rated 4repo 9mo ago A scan 1,173 tokens original MIT
View source ↗ tosssssy/mcp-server-debug-thinking
Reuse

Borrowing it

Nothing to install: this file belongs to tosssssy/mcp-server-debug-thinking. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/tosssssy/mcp-server-debug-thinking/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/tosssssy/mcp-server-debug-thinking

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mcp-server-debug-thinking CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/tosssssy/mcp-server-debug-thinking/claude-md/github.svg)](https://agentmods.dev/instructions/tosssssy/mcp-server-debug-thinking/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/tosssssy/mcp-server-debug-thinking/claude-md"><img src="https://agentmods.dev/badge/instructions/tosssssy/mcp-server-debug-thinking/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for mcp-server-debug-thinking CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/tosssssy/mcp-server-debug-thinking/claude-md"><img src="https://agentmods.dev/badge/instructions/tosssssy/mcp-server-debug-thinking/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,173 This file is loaded in full into every session.
When invoked 1,173 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01173 $0.01173
Opus 5.5 $0.00469 $0.00469
Sonnet 5.5 $0.00235 $0.00235
Haiku 4.5 $0.00117 $0.00117

Measured 2mo ago against content hash 4d1d3c65f278, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

mcp-server-debug-thinking CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 83 lines

How it starts

The opening of the file, as written. The whole thing — 83 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

このファイルは、Claude Code (claude.ai/code) がこのリポジトリのコードを扱う際のガイダンスを提供します。

ビルドと開発コマンド

  • ビルド: npm run build - TypeScriptをコンパイルして実行可能ファイルを作成
  • 開発: npm run dev - TypeScriptコンパイラをウォッチモードで実行
  • クリーン: npm run clean - distディレクトリを削除
  • リビルド: npm run rebuild - クリーンとビルドを連続実行
  • リント: npm run lint - TypeScriptファイルでESLintを実行
  • フォーマット: npm run format - Prettierでコードをフォーマット

アーキテクチャ概要

これは問題解決ツリーと仮説-実験-学習サイクルを使用した体系的なデバッグのための、グラフベースのMCP (Model Context Protocol) サーバーです。

コアサービス

  • GraphService (src/services/GraphService.ts): デバッグ知識グラフを管理するメインサービス

    • CREATE、CONNECT、QUERYアクションを処理
    • ノード（問題、仮説、実験、観察、学習、解決策）を管理
    • エッジ（ノード間の関係）を管理
    • パターン認識と検索機能を提供

  • GraphStorage (src/services/GraphStorage.ts): グラフデータの永続化を処理

    • ノードとエッジをJSONL形式で保存
    • グラフメタデータを管理
    • 効率的な読み込みと保存を提供

型システム

  • グラフ型 (src/types/graph.ts):

    • Node: すべてのグラフノードの基本型
    • Edge: ノード間の関係
    • DebugGraph: 完全なグラフ構造
    • 特定のノード型: ProblemNode、HypothesisNode、ExperimentNodeなど

  • アクション型 (src/types/graphActions.ts):

    • CreateAction: ノード作成のパラメータ
    • ConnectAction: エッジ作成のパラメータ
    • QueryAction: グラフ検索のパラメータ
    • 各アクションのレスポンス型

公開されているMCPツール

サーバーは単一のツールを公開しています: debug_thinking （3つのアクション付き）

  1. CREATE: 知識グラフにノードを追加

    • 親子関係に基づいて自動的にエッジを作成
    • すべてのノードタイプをサポート: problem、hypothesis、experiment、observation、learning、solution

  2. CONNECT: ノード間に明示的な関係を作成

    • 関係タイプをサポート: decomposes、hypothesizes、tests、produces、learns、contradicts、supports、solves

  3. QUERY: グラフを検索・分析

    • クエリタイプ: similar-problems、successful-patterns、learning-path、graph-visualizationなど

主要な設計パターン

  • グラフベースの知識表現: すべてのデバッグ知識は有向グラフとして保存
  • 自動エッジ作成: 親子関係は適切なエッジを自動的に作成
  • パターン認識: セッション間で成功したデバッグパターンを識別
  • TypeScriptファースト: 包括的な型定義により型安全性を確保
  • ファイルシステム永続化: グラフデータは.debug-thinking-mcp/ディレクトリに保存
  • モジュラーアーキテクチャ: グラフ操作、ストレージ、MCPインターフェース間の明確な分離

エントリーポイント

メインエントリーポイントはsrc/index.tsで、以下を行います：

  • stdioトランスポートを使用してMCPサーバーをセットアップ
  • アクションをGraphServiceメソッドにルーティング
  • MCP準拠の形式でレスポンスを処理

Read the full file on GitHub · 83 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 83 lines · 1,173 tokens per session scan A 4d1d3c65f278

Subscribe to this mod's changes

mcp-server-debug-thinking CLAUDE.md is an instructions file published in the GitHub repository tosssssy/mcp-server-debug-thinking (4 stars, last pushed 9mo ago), licensed MIT. It adds 1,173 tokens to every session, about $0.0047 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Building agentsDebugging
Related

mcp-server-debug-thinking CLAUDE.md compared with instructions from other repositories

mcp-server-debug-thinking CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
mcp-server-debug-thinking CLAUDE.mdtosssssy/mcp-server-debug-thinkingInstructions file49mo agoMITA1,173Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,516GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
vscode model-prompts.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA2,022GitHub Copilot