AI 에이전트가 의존성 매핑 및 영향 범위 분석(blast-radius impact analysis)을 통해 코드베이스를 검색, 인덱싱 및 분석할 수 있도록 지원합니다.
다른 이름 Code-Fundi/code-fundi-mcp, @codefundi/code-fundi-mcp
- 스타
- 1
- Tools
- 27
- 다운로드, 30일
- 287
- 최신 버전
- 0.1.4
- 마지막 커밋
- 2026년 10월 7일
- 라이선스
- —
Code Fundi MCP란?
Code Fundi은(는) MCP server입니다. AI 에이전트가 의존성 매핑 및 영향 범위 분석(blast-radius impact analysis)을 통해 코드베이스를 검색, 인덱싱 및 분석할 수 있도록 지원합니다. 27개 도구를 제공합니다. 예: code-fundi-search, code-fundi-research, code-fundi-list-repos.
프로젝트 README에서 생성된 요약
Code Fundi MCP server 정보
Code-Fundi MCP는 AI 코딩 어시스턴트에게 코드베이스에 대한 포괄적인 지도를 제공하여 리서치 및 영향 분석 능력을 향상시킵니다. 에이전트가 시맨틱 검색 및 grep 검색을 수행하고, 새로운 GitHub repository를 인덱싱하며, 파일에 대한 문서를 생성할 수 있도록 지원합니다. 이 MCP server는 Claude, Cursor, Windsurf, VS Code Copilot과 같은 MCP 호환 클라이언트에서 사용할 수 있도록 설계되었습니다.
사용자는 설정에 CODEFUNDI_API_KEY를 제공하거나 런타임 시 에이전트 기반 인증을 사용하여 연결할 수 있습니다. 이 런타임 프로세스에는 에이전트가 이메일을 요청하고 6자리 코드를 확인하는 OTP 셀프 인증 흐름 또는 비밀번호 로그인 방식이 포함됩니다. 서버는 세션 동안 인증 정보를 메모리에서 관리합니다.
단순한 검색을 넘어, 이 서버는 영향 분석을 위한 Blast-Radius Guard 및 교차 repository 의존성 매핑과 같은 도구를 통해 repository 인텔리전스를 제공합니다. 또한 사용 통계, 언어별 구성 비율 확인 및 심도 있는 코드베이스 탐색을 위한 전용 AI 채팅 인터페이스를 제공합니다.
활용 사례
- 1코드 변경 영향 분석AI 에이전트가 blast-radius 엔진을 사용하여 제안된 변경 사항으로 인해 어떤 파일과 함수가 손상될지 판단할 수 있습니다.
- 2서비스 의존성 매핑개발자는 이 서버를 사용하여 여러 repository에 걸쳐 서로 다른 서비스와 패키지가 어떻게 연결되어 있는지 시각화할 수 있습니다.
- 3심도 있는 코드베이스 리서치 수행에이전트가 검색 쿼리와 AI 합성 분석을 결합하여 인덱싱된 repository 내의 복잡한 로직을 이해할 수 있습니다.
- 4repository 인덱싱 자동화서버를 통해 AI가 향후 쿼리에 사용할 새로운 GitHub repository를 지식 베이스에 추가할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Code Fundi MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Code Fundi MCP 설치
$ claude mcp add code-fundi-mcp -- npx -y @codefundi/code-fundi-mcpCursor에 Code Fundi MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"code-fundi-mcp": {
"command": "npx",
"args": [
"-y",
"@codefundi/code-fundi-mcp"
]
}
}
}VS Code에 Code Fundi MCP 설치
.vscode/mcp.json
{
"servers": {
"code-fundi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codefundi/code-fundi-mcp"
]
}
}
}VS Code CLI에 Code Fundi MCP 설치
$ code --add-mcp '{"name":"code-fundi-mcp","type":"stdio","command":"npx","args":["-y","@codefundi/code-fundi-mcp"]}'Claude Desktop에 Code Fundi MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"code-fundi-mcp": {
"command": "npx",
"args": [
"-y",
"@codefundi/code-fundi-mcp"
]
}
}
}Codex에 Code Fundi MCP 설치
$ codex mcp add code-fundi-mcp -- npx -y @codefundi/code-fundi-mcpCodex config.toml에 Code Fundi MCP 설치
~/.codex/config.toml
[mcp_servers.code-fundi-mcp] command = "npx" args = ["-y", "@codefundi/code-fundi-mcp"]
Gemini CLI에 Code Fundi MCP 설치
$ gemini mcp add -s user code-fundi-mcp npx -- -y @codefundi/code-fundi-mcpGemini settings.json에 Code Fundi MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"code-fundi-mcp": {
"command": "npx",
"args": [
"-y",
"@codefundi/code-fundi-mcp"
]
}
}
}Code Fundi MCP 도구 27
README에서 감지됨code-fundi-searchcode-fundi-researchcode-fundi-list-reposcode-fundi-index-repocode-fundi-repo-statuscode-fundi-repo-readmecode-fundi-list-public-reposcode-fundi-repo-mapcode-fundi-repo-blueprintcode-fundi-repo-radiuscode-fundi-list-filescode-fundi-file-docs
| code-fundi-search | — | |
| code-fundi-research | — | |
| code-fundi-list-repos | — | |
| code-fundi-index-repo | — | |
| code-fundi-repo-status | — | |
| code-fundi-repo-readme | — | |
| code-fundi-list-public-repos | — | |
| code-fundi-repo-map | — | |
| code-fundi-repo-blueprint | — | |
| code-fundi-repo-radius | — | |
| code-fundi-list-files | — | |
| code-fundi-file-docs | — |
도구 27개 모두 보기도구 수 줄이기
code-fundi-list-historycode-fundi-history-itemcode-fundi-conversationcode-fundi-usage-statscode-fundi-activity-statscode-fundi-language-statscode-fundi-auth-authenticatecode-fundi-auth-verifycode-fundi-auth-resendcode-fundi-list-api-keyscode-fundi-regenerate-api-keycode-fundi-disable-api-keycode-fundi-chatcode-fundi-list-modelscode-fundi-model-limits
| code-fundi-list-history | — | |
| code-fundi-history-item | — | |
| code-fundi-conversation | — | |
| code-fundi-usage-stats | — | |
| code-fundi-activity-stats | — | |
| code-fundi-language-stats | — | |
| code-fundi-auth-authenticate | — | |
| code-fundi-auth-verify | — | |
| code-fundi-auth-resend | — | |
| code-fundi-list-api-keys | — | |
| code-fundi-regenerate-api-key | — | |
| code-fundi-disable-api-key | — | |
| code-fundi-chat | — | |
| code-fundi-list-models | — | |
| code-fundi-model-limits | — |
구성
CODEFUNDI_API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| CODEFUNDI_API_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능code-fundi/code-fundi-mcp is public and reachablegithub.com/code-fundi/code-fundi-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시@codefundi/code-fundi-mcp names code-fundi/code-fundi-mcp as sourcenpmjs.com/package/@codefundi/code-fundi-mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-07github.com/code-fundi/code-fundi-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @codefundi/code-fundi-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음158 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음27 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Code-Fundi MCP Server
A production-grade Model Context Protocol (MCP) server for the Code-Fundi API: a codebase map and blast-radius engine for AI coding agents. Enables any MCP-compatible AI assistant (Claude, Claude Code, Cursor, Windsurf, VS Code Copilot, and more) to search, research, index, and scan code repositories through natural language, and see what a change breaks before it ships.
Built with FastMCP (TypeScript) and Zod for schema validation.
Getting started for AI agents
If you are an AI agent (or configuring one) and no CODEFUNDI_API_KEY is set, you must self-authenticate before using search, repos, chat, or other authenticated tools. The auth tools (code-fundi-auth-*) work without a pre-existing key.
Which path to use
| Situation | Action |
|---|---|
CODEFUNDI_API_KEY is set in MCP config |
Use any tool immediately — the server sends it as X-API-Key on every request |
| No API key configured | Run the OTP self-auth flow below (recommended) or password sign-in |
Zero-config MCP setup (no API key)
You can start the MCP server without CODEFUNDI_API_KEY and authenticate at runtime:
{
"mcpServers": {
"code-fundi": {
"command": "npx",
"args": ["-y", "@codefundi/code-fundi-mcp"]
}
}
}
Self-authenticate with OTP (recommended)
Code-Fundi uses Supabase-backed auth (POST /v2/auth/authenticate, /v2/auth/verify, /v2/auth/resend). OTP emails contain a 6-digit code — magic links are not supported on this path.
- Ask the human user for their email address.
- Call
code-fundi-auth-authenticatewith:auth_mode:"otp"email: the user's emailshould_create_user:truefor a new account,falsefor a returning user
- Tell the user to check their inbox for a 6-digit code. The API may return
verification_required: trueandapi_key.key_state: "agent_pending"until verification completes. - Ask the user for the 6-digit OTP (human-in-the-loop — you cannot guess or bypass this step).
- Call
code-fundi-auth-verifywith the sameemailand thetoken(6 digits). - On success, the MCP server automatically configures the API key in memory for all subsequent tool calls in this session.
If the code expired or was not received, call code-fundi-auth-resend with the same email, then repeat step 5.
Example dialogue:
Agent: What email should I use to sign in to Code-Fundi?
User: dev@example.com
Agent: [calls code-fundi-auth-authenticate] I've sent a 6-digit code to dev@example.com. Please paste it here.
User: 482913
Agent: [calls code-fundi-auth-verify] You're signed in. I can now search and index your repositories.
Password sign-in (alternative)
For existing accounts with a password, call code-fundi-auth-authenticate with auth_mode: "password", the user's email, should_create_user: false, and the password parameter. The MCP client sends the password only in the X-CodeFundi-Auth-Password header (never in the JSON body). Production requires HTTPS. Returning users may receive an active API key immediately without a separate verify step.
After authentication
- The API key is held in memory for the lifetime of the MCP server process. It is not persisted across IDE or MCP restarts.
- Recommend the user add the key to their MCP config as
CODEFUNDI_API_KEYso future sessions start authenticated. - A FREE-tier account and API key are created automatically on first signup.
Errors
| HTTP status | What to do |
|---|---|
| 401 Unauthorized | No valid key — run the OTP flow above, or set CODEFUNDI_API_KEY |
| 429 Too many requests | Auth endpoints are rate-limited per IP; wait for Retry-After seconds, then retry |
Features
Every tool below is backed by the same codebase map: structural dependencies, call graph, and blast radius, indexed once and queried in milliseconds.
- 🔍 Semantic & grep code search across your indexed codebase map
- 🧠 AI-powered research: search plus AI analysis in a single call
- 📦 Repository management: index, status, README, listing, public catalog
- 🛰️ Repository intelligence: cross-repo dependency map, blueprint, Blast-Radius Guard (impact analysis before you merge)
- 📄 File documentation: AI-generated docs for any indexed file
- 📊 Usage statistics: query usage, activity, language breakdowns
- 🔐 Agent-driven authentication: sign up/sign in via OTP without pre-configured keys
- 💬 AI chat & model insight: direct conversation with Code-Fundi AI, model catalog, and per-tier limits
Quick Start
Install from npm (recommended)
Install the package (includes a pre-built dist/). The code-fundi-mcp binary is on your PATH when installed globally, or available via npx without cloning the repo:
npm install -g @codefundi/code-fundi-mcp
Or add it to a project:
npm install @codefundi/code-fundi-mcp
Install from source (this repository)
git clone https://github.com/Code-Fundi/code-fundi-mcp.git
cd code-fundi-mcp
npm install
npm run build
Configure
Option A — API key (fastest): set your key as an environment variable:
export CODEFUNDI_API_KEY=your_api_key_here
Option B — no API key: skip the env var and let the agent self-authenticate at runtime. See Getting started for AI agents.
Zero-config MCP example (no env block):
{
"mcpServers": {
"code-fundi": {
"command": "npx",
"args": ["-y", "@codefundi/code-fundi-mcp"]
}
}
}
Use with Claude Desktop
After a global install (npm i -g @codefundi/code-fundi-mcp), point MCP at the published binary (no path to dist/index.js required):
{
"mcpServers": {
"code-fundi": {
"command": "@codefundi/code-fundi-mcp",
"env": {
"CODEFUNDI_API_KEY": "your_api_key_here"
}
}
}
}
If the binary is not on your PATH, use npx (downloads or uses the local package and runs the same entrypoint):
{
"mcpServers": {
"code-fundi": {
"command": "npx",
"args": ["-y", "@codefundi/code-fundi-mcp"],
"env": {
"CODEFUNDI_API_KEY": "your_api_key_here"
}
}
}
}
Use with Cursor
Same pattern as Claude: command plus optional args only, no manual path to the repo:
{
"mcpServers": {
"code-fundi": {
"command": "npx",
"args": ["-y", "@codefundi/code-fundi-mcp"],
"env": {
"CODEFUNDI_API_KEY": "your_api_key_here"
}
}
}
}
When developing inside this repo, you can run npm run dev or npx tsx src/index.ts without building first.
Development Mode
npm run dev # Run with tsx (no build needed)
npx fastmcp inspect src/index.ts # Open MCP Inspector UI
npx fastmcp dev src/index.ts # Test with MCP CLI
Tools Reference (27 tools)
Covers the Code-Fundi V2 API for codebase mapping and blast-radius analysis: search (including search-with-chat / research), repositories (list, index, status, readme, public catalog), repository intelligence (map, blueprint, radius), files, history, statistics, API keys, authentication, plus Fundi chat (POST /v1/fundi/chat) and the V2 model catalog / limits (GET /v2/models, GET /v2/models/limits).
Search
| Tool | Description |
|---|---|
code-fundi-search |
Semantic and grep search across your indexed codebase map, with filters |
code-fundi-research |
Search plus AI-synthesized analysis of matching code |
Repositories
| Tool | Description |
|---|---|
code-fundi-list-repos |
List indexed repositories with pagination |
code-fundi-index-repo |
Index a new GitHub repository into your codebase map |
code-fundi-repo-status |
Check repository indexing status |
code-fundi-repo-readme |
Get repository README documentation (deprecated, prefer blueprint) |
code-fundi-list-public-repos |
Browse the global catalog of indexed public repositories (no key needed) |
Repository Intelligence
| Tool | Description |
|---|---|
code-fundi-repo-map |
Cross-repository dependency map: how services and packages actually connect |
code-fundi-repo-blueprint |
README plus dependency and convention overview (successor to repo-readme) |
code-fundi-repo-radius |
Blast-Radius Guard: every file and function that breaks before you merge (PRO+) |
Files
| Tool | Description |
|---|---|
code-fundi-list-files |
List files in a repository |
code-fundi-file-docs |
Get AI-generated file documentation |
History
| Tool | Description |
|---|---|
code-fundi-list-history |
List query history with filters |
code-fundi-history-item |
Get full details of a history entry |
code-fundi-conversation |
Get conversation thread messages |
Statistics
| Tool | Description |
|---|---|
code-fundi-usage-stats |
Query-type usage breakdown |
code-fundi-activity-stats |
Daily activity statistics |
code-fundi-language-stats |
Programming language usage |
Authentication
| Tool | Description |
|---|---|
code-fundi-auth-authenticate |
Start OTP/password auth flow (no key needed) |
code-fundi-auth-verify |
Verify OTP code and obtain API key |
code-fundi-auth-resend |
Resend OTP verification email |
code-fundi-list-api-keys |
List API keys (masked) |
code-fundi-regenerate-api-key |
Regenerate API key |
code-fundi-disable-api-key |
Disable an API key by ID (DELETE /v2/keys/{key_id}) |
Chat & Models
| Tool | Description |
|---|---|
code-fundi-chat |
Fundi AI chat (POST /v1/fundi/chat; streamed responses are collected to text) |
code-fundi-list-models |
List the curated chat model catalog (GET /v2/models) |
code-fundi-model-limits |
Get AI model limits and tier configuration (GET /v2/models/limits) |
Authentication
Two modes: pre-configured API key (CODEFUNDI_API_KEY in MCP config) or agent-driven OTP/password auth at runtime. Full step-by-step instructions, tool names, and error handling are in Getting started for AI agents at the top of this README.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
CODEFUNDI_API_KEY |
No* | — | API key for authentication |
CODEFUNDI_BASE_URL |
No | https://api.codefundi.app |
API base URL override |
* Required unless using agent-driven auth tools.
License
MIT
Code Fundi MCP 질문
Code Fundi MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add code-fundi-mcp -- npx -y @codefundi/code-fundi-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Code Fundi MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Code Fundi MCP는 어떤 도구를 제공하나요?
27개 도구를 제공합니다. 예: code-fundi-search, code-fundi-research, code-fundi-list-repos, code-fundi-index-repo, code-fundi-repo-status.
사전 설정된 API 키 없이 Code Fundi를 어떻게 사용하나요?
제공된 인증 도구를 통해 런타임 시 OTP 셀프 인증 흐름이나 비밀번호 로그인을 사용할 수 있습니다.
서버를 재시작해도 API 키가 유지되나요?
아니요, API 키는 프로세스가 실행되는 동안에만 메모리에 유지되며 IDE나 MCP 재시작 시에는 유지되지 않습니다.