
jurasofish/mcpunk
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP инструменты для роуминга RAG
Обзор
MCPunk позволяет исследовать и понимать кодовые базы посредством разговора. Он работает: 1. Разбиение файлов на логические куски (функции, классы, разделы разметки) 2. Предоставление инструментов LLM для поиска и запроса этих кусков 3. Позвольте LLM найти конкретный код, необходимый для ответа на ваши вопросы. Никаких вложений, никакой сложной конфигурации - просто четкий, проверяемый поиск, который вы можете видеть и направлять. Он отлично работает с Claude Desktop или любым другим клиентом MCP. LLM могут быть отличными, но только при наличии соответствующего контекста. - LLM нужен контекст, но они не могут справиться с этим. Паршиво! MCPunk - это RAG, который по своей сути предоставляет контекстные подсказки LLM, позволяя LLM действительно сужать только соответствующий контент. - может точно видеть, какие данные LLM рассмотрел и как он нашел, может прыгать в чат и направлять вещи, где вы хотите. Это инструкции для Claude Desktop, но MCPunk можно использовать везде, где используется MCP. 1. 1. (Подробнее о claude desktop config.
Обзор (машинный перевод)
**Общайтесь с вашей кодовой базой без встраивания, предоставляя инструменты LLM для интеллектуального поиска вашего кода.
MCPunk позволяет исследовать и понимать кодовые базы посредством разговора. Он работает:
1 Разбиение файлов на логические фрагменты (функции, классы, разделы разметки) 2. Предоставление инструментов LLM для поиска и запроса этих фрагментов 3.Пусть LLM найдет конкретный код, необходимый для ответа на ваши вопросы
Никаких вложений, никакой сложной конфигурации - просто четкий, проверяемый поиск, который вы можете видеть и направлять. Он отлично работает с Claude Desktop или любым другим клиентом MCP.
Репозиторий GitHub
Построенный с учетом следующего
Контекст King - LLM могут быть отличными, но только при наличии соответствующего контекста. Контекст Драгоценен - LLM нуждаются в контексте, но они не могут справиться с слишком много. Паршиво! MCPunk - это RAG, который по своей сути обеспечивает контекстный LLM. Подсказки, позволяющие LLM действительно сузить только соответствующий контент. ** Человек в петле ** ** Вы можете увидеть, какие именно данные рассмотрел LLM И как он нашел это, вы можете прыгать в чат и направлять вещи, где вы хотите.
Настройка
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
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:
- Breaking files into logical chunks (functions, classes, markdown sections)
- Giving the LLM tools to search and query these chunks
- 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.
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.
- Install uv
- Put the snippet below in your
claude_desktop_config.json(Details aboutclaude_desktop_config.jsonincluding location) - Restart Claude Desktop and you should see the tools available after a small delay, like the screengrab below
- 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:
Установка
uvx mcpunkКонфигурация
{
"mcpServers": {
"MCPunk": {
"command": "uvx",
"args": ["mcpunk"]
}
}
}