DevPulse MCP server
Commit Oct 23, 2026Enables AI assistants to perform codebase analytics, dependency inspection, technical debt scanning, and Git history analysis.
Also known as eren074/devpulse-mcp
- Stars
- 0
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 23, 2026
- License
- MIT
What is DevPulse MCP?
DevPulse enables AI assistants to perform codebase analytics, dependency inspection, technical debt scanning, and Git history analysis. It exposes 4 tools, such as analyze_codebase, inspect_dependencies, scan_todos.
Summary generated from the project's README
About DevPulse MCP server
Analyzing software projects and technical debt from within AI assistants like Claude Desktop, Cursor, or VS Code Copilot is what DevPulse MCP enables. It provides a structured way for models to inspect local codebases by scanning programming languages, counting lines of code, and identifying specific files. Developers can use it to gain immediate visibility into project structures without manual searching.
The server operates locally and uses the Model Context Protocol to expose four specific tools: analyze_codebase, inspect_dependencies, scan_todos, and git_repository_insights. It also provides system environment details and README content as resources. To set it up, you need Python 3.11 or later and the uv package manager to run the server via stdio or streamable-http.
Security is a core focus, as the server runs in a read-only mode that prevents file modifications or data transmission to the internet. It includes built-in protections against path traversal, command injection, and access to sensitive directories like .ssh or .env. It also manages performance by limiting folder depth and file sizes to prevent system hangs.
What you can do with it
- 1Inspect project dependenciesRequest a structured report of all libraries used in Python or Node.js projects.
- 2Analyze codebase statisticsHave the assistant calculate the distribution of programming languages and total lines of code.
- 3Review Git repository statusGet a summary of the current active branch, uncommitted changes, and recent commit history.
Written from the project's README. Every use case is checked against a quote from it.
DevPulse MCP tools 4
Detected from the READMEanalyze_codebaseinspect_dependenciesscan_todosgit_repository_insights
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableeren074/devpulse-mcp is public and reachablegithub.com/eren074/devpulse-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-23github.com/eren074/devpulse-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub🚀 DevPulse MCP — Kod Tabanı ve Teknik Borç Analiz Sunucusu
DevPulse MCP, resmi Model Context Protocol (MCP) Python SDK (v2) kullanılarak geliştirilmiş açık kaynaklı bir MCP sunucusu ve istemcisidir.
🎯 Projenin Amacı Nedir?
Yapay zeka asistanları (Claude Desktop, Cursor, VS Code Copilot vb.) bir yazılım projesini incelerken genellikle hangi dillerin kullanıldığını, hangi kütüphanelerin yüklü olduğunu, unutulmuş TODO/FIXME notlarını veya Git geçmişini tek seferde göremez.
DevPulse MCP'nin amacı, yerel bilgisayarınızdaki yazılım projelerinin röntgenini çekmek ve bu verileri standart MCP protokolü üzerinden yapay zeka modellerine güvenli, hızlı ve yapılandırılmış (tip güvenli) bir şekilde sunmaktır.
⚙️ Ne İşe Yarar? (Özellikler ve Araçlar)
Sunucu, yapay zeka asistanlarına 4 ana araç (Tool), 2 sistem kaynağı (Resource) ve 1 hazır denetim şablonu (Prompt) kazandırır:
🛠️ 1. Araçlar (Tools)
analyze_codebase(Kod Tabanı İstatistikleri): Proje klasöründeki tüm kaynak kod dosyalarını tarar; hangi programlama dilinden kaç dosya ve toplam kaç satır kod bulunduğunu hesaplar.inspect_dependencies(Bağımlılık ve Kütüphane Analizi): Projedekipyproject.toml,requirements.txt(Python) vepackage.json(Node.js) dosyalarını otomatik okur. Kullanılan kütüphaneleri Pydantic Structured Output (DependencyReport) şemasıyla doğrulanmış olarak döndürür.scan_todos(Teknik Borç Tarayıcı): Kod dosyalarının içinde unutulmuşTODO,FIXMEveBUGetiketlerini tarar; hangi dosyanın kaçıncı satırında ne yazdığını listeler.git_repository_insights(Git Geçmişi ve Durum Analizi): Projenin aktif Git dalını (branch), henüz kaydedilmemiş (uncommitted) dosya değişikliklerini ve son commit mesajlarını raporlar.
📦 2. Kaynaklar (Resources)
system://environment: Çalışılan ortamın işletim sistemi, mimari ve Python sürüm bilgisini sunar.project://readme/{project_name}: ProjeninREADME.mddosyasını LLM'e bağlam (context) olarak okur.
💬 3. Hazır İstem Şablonu (Prompt)
code_audit_prompt: Yapay zekanın yukarıdaki tüm araçları sırasıyla çalıştırarak projede kapsamlı bir mimari denetim yapmasını sağlayan hazır mühendislik şablonudur.
🔒 Güvenlik Mimarisi (Security by Design)
DevPulse MCP, yerel dosya sistemiyle çalıştığı için katı güvenlik önlemleriyle donatılmıştır:
- Salt Okunur Çalışma (
read_only_hint=True): Hiçbir dosyayı değiştirmez, silmez veya dış internete veri göndermez (open_world_hint=False). - Path Traversal & Sistem Dizini Engeli:
/etc,/var,/Systemgibi işletim sistemi dizinlerine ve.ssh,.aws,.gnupggibi anahtar klasörlerine erişimi otomatik reddeder. - Hassas Dosya ve Symlink Koruması:
.env,secret,token,credentialsiçeren dosya adlarını ve sembolik bağlantıları (symlink) tarama dışı bırakır. - Komut Enjeksiyonu (Command Injection) Koruması: Git alt süreçleri
shell=Falseve zaman aşımı (timeout) sınırıyla izole çalıştırılır. - DoS / Kilitlenme Koruması: Maksimum klasör derinliği (
max_depth=2), dosya boyutu sınırı (1 MB) ve dosya sayısı sınırı ile büyük dizinlerde zaman aşımını önler.
💻 Bilgisayara Nasıl Kurulur ve Çalıştırılır?
Gereksinimler
- Python 3.11 veya daha güncel bir sürüm
- uv (Modern Python paket yöneticisi)
Adım 1: Projeyi İndirin ve Bağımlılıkları Kurun
Terminalinizi açın ve aşağıdaki komutları sırasıyla çalıştırın:
# 1. Eğer bilgisayarınızda 'uv' yüklü değilse kurun (macOS / Linux):
curl -LsSf [https://astral.sh/uv/install.sh](https://astral.sh/uv/install.sh) | sh
# 2. Repoyu bilgisayarınıza klonlayın ve klasöre girin:
git clone [https://github.com/eren074/devpulse-mcp.git](https://github.com/eren074/devpulse-mcp.git)
cd devpulse-mcp
# 3. Bağımlılıkları sanal ortama yükleyin:
uv sync
Adım 2: Sunucuyu Test Edin
Projeyi kurduktan sonra doğru çalıştığını doğrulamak için 3 farklı test yöntemini kullanabilirsiniz:
# Yöntem A: Terminalde 1 saniyelik hızlı tanı testi
uv run python server.py --test
# Yöntem B: Otomatik birim testlerini (pytest) çalıştırma
uv run pytest -v
# Yöntem C: MCP Inspector ile tarayıcıda görsel test (Node.js / npx gerektirir)
uv run mcp dev server.py
🔌 Python İstemcisi (client.py) ile Kod İçinden Kullanım
Bu repo aynı zamanda sunucuya Streamable HTTP protokolüyle bağlanan örnek bir Python istemcisi (client.py) içerir. Denemek için iki ayrı terminal açın:
1. Terminal (Sunucuyu Başlatın):
uv run mcp run server.py --transport streamable-http
2. Terminal (İstemciyi Çalıştırın):
uv run python client.py
🤖 Cursor, VS Code veya Claude Desktop'a Nasıl Bağlanır?
Sunucuyu kullandığınız yapay zeka uygulamasına bağlamak için uygulamanın MCP ayar dosyasına aşağıdaki JSON bloğunu eklemeniz yeterlidir ( /TAM/DOSYA/YOLU/devpulse-mcp kısmına projeyi indirdiğiniz klasörün tam yolunu yazın):
Cursor (.cursor/mcp.json) veya Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"devpulse": {
"command": "uv",
"args": [
"--directory",
"/TAM/DOSYA/YOLU/devpulse-mcp",
"run",
"server.py"
]
}
}
}
VS Code GitHub Copilot (.vscode/mcp.json)
{
"servers": {
"devpulse": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"/TAM/DOSYA/YOLU/devpulse-mcp",
"run",
"server.py"
]
}
}
}
Bağlantıyı yaptıktan sonra yapay zeka asistanınıza şu soruyu sorarak sunucuyu kullanmaya başlayabilirsiniz:
"DevPulse araçlarını kullanarak projemin dil dağılımını, bağımlılıklarını, Git durumunu ve unutulmuş TODO notlarını analiz et."
📄 Lisans
Bu proje MIT Lisansı altında lisanslanmıştır.
DevPulse MCP questions
What tools does DevPulse MCP provide?
It exposes 4 tools, including analyze_codebase, inspect_dependencies, scan_todos, git_repository_insights.
How do I connect DevPulse to Claude Desktop or Cursor?
You can connect it by adding a JSON configuration block to your application's MCP settings file, specifying the command as 'uv' and pointing to the project directory.