LLMツールをインテリジェントに検索することで、埋め込むことなく、コードベースとチャットできます。

MCPunk では、会話を通してコードベースを探索し理解することができます。 それはによって働きます:

1. ファイルを論理チャンク(機能、クラス、マークダウンセクション)に分割する
2. これらのチャンクを検索し、クエリするためにLMツールを与える
3. LLM が質問に答える必要がある特定のコードを見つけよう

埋め込みなし、複雑な構成なし - 明確で、監査可能な検索で、見やすくガイドできます。 Claude デスクトップ、またはその他の MCP クライアントで動作します。

GitHubリポジトリ

以下を念頭に置いて構築

• ContextはKing - LLMは、適切なコンテキストで提供される場合にのみ、素晴らしいことができます。
• Context は Precious - LLM はコンテキストを必要としますが、あまり処理できません。 悲しい! MCPunk は LLM のコンテキストを本質的に提供する RAG です ヒントは、LM が関連するコンテンツだけに非常に狭いようにします。 -Loopの人間 -**LLMが考慮したデータを正確に見ることができる そして、それがどのように見つけたのか、**あなたはチャットにジャンプし、あなたが望むどこでも物事を指示することができます。

セットアップ

MCPunk 🤖

Chat with your codebase without embeddings by giving the LLM tools to search your code intelligently.

MCPunk lets you explore and understand codebases through conversation. It works by:

1. Breaking files into logical chunks (functions, classes, markdown sections)
2. Giving the LLM tools to search and query these chunks
3. Letting the LLM find the specific code it needs to answer your questions

No embeddings, no complex configuration - just clear, auditable searching that you can see and guide. It works great with Claude Desktop, or any other MCP client.

GitHub Repository

Built with the following in mind

• Context is King - LLMs can be great but only if provided with appropriate context.
• Context is Precious - LLMs need context, but they can’t handle too much. A travesty! MCPunk is RAG that inherently provides the LLM contextual hints, allowing the LLM to really narrow in on only the relevant content.
• Human in the Loop - You can see exactly what data the LLM has considered and how it found it, You can jump into chat and direct things wherever you want.

Setup

These are instructions for Claude Desktop, but MCPunk can be used anywhere MCP is used.

1. Install uv
2. Put the snippet below in your claude_desktop_config.json (Details about claude_desktop_config.json including location)
3. Restart Claude Desktop and you should see the tools available after a small delay, like the screengrab below
4. Chat away: “hey pal can you set up the ~/git/mcpunk project and tell me how python files are chunked”

("command": "uvx", might not work, and you may need to use e.g. "command": "/Users/michael/.local/bin/uvx",)

{
  "mcpServers": {
    "MCPunk": {
      "command": "uvx",
      "args": ["mcpunk"]
    }
  }
}

Usage Examples

Answer Questions About Your Codebase

• [User] Hey pal can you please set up the ~/git/mcpunk repo, then help me understand how a user of mcpunk would get the git diff of the currently checked out branch in the repo that they have configured with mcpunk
• [Claude] Call configure_project
• [Claude] Call list_all_files_in_project
• [Claude] Call find_files_by_chunk_content
• [Claude] … makes a total of 21 tool calls with MCPunk.
• [Claude] Now I understand how the git diff functionality works in mcpunk. Let me summarize how a user would get the git diff of the currently checked out branch: