MCP Think Tank

by flight505
MIT License
152
2
  • Apple
  • Linux

Integrations

  • Built for Node.js 18+, enabling server-side execution of the MCP Think Tank functionality.

  • Provides comprehensive task management tools for planning, tracking, and updating tasks with knowledge graph integration for persistent project management.

  • Built with TypeScript support, providing type safety for developers integrating with or extending the MCP Think Tank server.

MCP 싱크탱크

개요

MCP 싱크탱크는 커서클로드 @웹 에 향상된 추론 기능을 위한 정교한 환경을 제공합니다. 고급 순차적 사고 및 연쇄 추론 프로세스, 버전 관리 기능을 갖춘 강력한 지식 그래프 메모리 시스템, 그리고 호출 제한 보호 기능을 갖춘 지능형 도구 오케스트레이션 기능을 제공합니다 .

이 플랫폼을 사용하면 AI 도우미가 구조화된 다단계 추론을 통해 복잡한 문제에 접근하고, 대화 전반에 걸쳐 지속적인 지식을 유지하고, 웹 조사 및 작업 관리 기능을 활용할 수 있습니다. 이 모든 것이 내장된 보안 장치를 통해 책임감 있고 효율적인 도구 사용을 보장합니다.

🎯 철학

MCP 싱크탱크는 세 가지 핵심 원칙을 기반으로 구축되었습니다.

  1. 우아한 단순함 : 우리는 클로드의 자연스러운 능력을 복제하거나 무시하려고 하기보다는, 클로드의 자연스러운 능력에 맞는 최소한의 잘 디자인된 도구의 힘을 믿습니다.
  2. 향상된 반성 : 엄격한 구조 대신 부드러운 지침을 제공함으로써 클로드의 사고 과정을 제약하지 않고도 더 나은 추론과 자기 반성을 가능하게 합니다.
  3. 지속적인 컨텍스트 : 지식 그래프는 저장과 검색 모두에서 단순성을 유지하면서 대화 전반에 걸쳐 메모리를 제공합니다.

🧠 구조적 사고의 힘

Think Tool은 체계적인 추론을 위한 전용 공간을 제공하여 다음을 장려합니다.

  • 명확한 문제 정의
  • 관련 컨텍스트 수집
  • 단계별 분석
  • 추론에 대한 자기 성찰
  • 잘 구성된 결론

최근 연구에 따르면 구조적 사고를 사용하면 상당한 개선이 나타나는 것으로 나타났습니다.

  • 복잡한 의사결정 작업에서 상대적 54% 개선
  • 여러 시험에 걸쳐 향상된 일관성
  • 소프트웨어 엔지니어링 벤치마크에서 향상된 성능

🚀 주요 특징

  • 💭 Think Tool : 체계적인 추론과 자기성찰을 위한 전용 공간
  • 🧩 지식 그래프 : 간단하지만 효과적인 지속적 메모리
  • 📝 작업 관리 도구 : 전체 지식 그래프 통합을 통해 작업을 계획, 추적 및 업데이트합니다.
  • 🌐 웹 리서치 도구(Exa) : Exa API를 사용하여 웹을 검색하고 소스에서 답변을 얻으세요
  • 🔍 기억 도구 : 정보를 저장하고 검색하기 위한 사용하기 쉬운 도구
  • 🤝 클라이언트 지원 : Cursor, Claude @Web 및 기타 MCP 클라이언트와의 원활한 통합
  • 🔒 도구 오케스트레이션 및 호출 제한 : 구성 가능한 제한을 통해 과도한 도구 사용을 방지하는 내장형 보호 기능
  • 콘텐츠 캐싱 : 자동 중복 감지를 통해 파일 및 URL 작업에 대한 성능 최적화
  • 🔄 순차적 사고 : 진행 상황 추적 및 계획 인식을 통한 다단계 추론 프로세스
  • 🔎 자기 반성 : 추론에 대한 자동 반성을 통해 출력 품질을 향상시킵니다.
  • 📊 구조화된 출력 : 더 나은 가독성을 위한 사고 과정의 자동 포맷
  • 🔗 연구 통합 : 웹 연구를 추론 흐름에 원활하게 통합

순차적 사고와 연쇄 추론

최신 버전에서는 강력한 다단계 추론 기능이 도입되었습니다.

  • 단계별 계획 : 복잡한 문제를 관리 가능한 순차적 단계로 분해
  • 진행 상황 추적 : 단계 카운터를 사용하여 여러 단계 추론을 통해 진행 상황을 모니터링합니다.
  • 자기 반성 : 선택적 반성 패스를 통해 추론 품질을 자동으로 평가합니다.
  • 연구 통합 : 추론 체인 내에 웹 연구를 원활하게 통합합니다.
  • 구조화된 포맷 : 더 나은 이해를 위해 깔끔하고 체계적인 포맷으로 추론을 출력합니다.

향상된 지식 그래프 메모리

지식 그래프 시스템이 크게 업그레이드되었습니다.

  • 타임스탬프가 지정된 관찰 : 모든 메모리 항목에 이제 더 나은 추적을 위한 메타데이터가 포함됩니다.
  • 중복 방지 : 중복 항목을 방지하기 위한 지능형 엔터티 매칭
  • 자동 연결 : 관련 엔터티 간의 휴리스틱 기반 관계 생성
  • 고급 쿼리 : 시간, 태그, 키워드 등으로 메모리 필터링
  • 메모리 유지 관리 : 시간 경과에 따른 메모리 증가를 정리하고 관리하기 위한 도구

도구 오케스트레이션 및 보호

새로운 지능형 도구 관리 기능은 책임감 있고 효율적인 도구 사용을 보장합니다.

  • 사용 제한 : 도구 호출에 대한 구성 가능한 제한(기본값: 25)을 통해 폭주 사용을 방지합니다.
  • 호출 캐싱 : 효율성을 위해 중복 도구 호출을 자동으로 감지하고 재사용합니다.
  • 콘텐츠 캐싱 : 중복 읽기를 줄이기 위한 파일 및 URL 작업에 대한 SHA-1 기반 캐싱
  • 우아한 저하 : 부분 결과가 반환된 한계 오류의 깔끔한 처리
  • 도구 허용 목록 : 특정 컨텍스트에서 사용할 수 있는 도구에 대한 구성 가능한 제한

📦 설치

⚠️ 중요: MCP Think Tank는 사전 구축된 서버가 필요합니다. 패키지는 게시 전에 자동으로 구축되므로 사용자는 추가 단계를 수행할 필요가 없습니다. 설치 후 실행하기만 하면 됩니다!

NPX (추천)

MCP Think Tank를 사용하는 가장 쉬운 방법은 NPX를 이용하는 것입니다.

지엑스피1

글로벌 설치

npm install -g mcp-think-tank mcp-think-tank

⚙️ 구성

빠른 시작: 필수 설정

  1. MCP Think Tank 설치 (위의 설치 참조)
  2. Exa API 키를 받으세요 (웹 검색에 필요):
    • exa.ai 에 가입하고 API 키를 복사하세요.
  3. MCP 서버를 구성합니다 (Cursor의 경우 .cursor/mcp.json 에 추가):
{ "mcpServers": { "think-tool": { "command": "npx", "args": ["-y", "mcp-think-tank"], "type": "stdio", "env": { "MEMORY_PATH": "/absolute/path/to/your/memory.jsonl", "EXA_API_KEY": "your-exa-api-key-here" } } } }

⚠️ 중요: 항상 각 프로젝트마다 고유한 MEMORY_PATH 설정하세요!

기본(중앙 집중식) 메모리 경로를 사용하면 프로젝트 간에 지식 그래프 충돌이 발생할 수 있습니다. 최상의 결과를 얻고 프로젝트 메모리를 분리하려면 모든 프로젝트에 대해 구성에서 사용자 지정 MEMORY_PATH 지정하세요. 생략하면 기본값은 ~/.mcp-think-tank/memory.jsonl 입니다.

환경 변수

필수 변수
  • MEMORY_PATH : 메모리 저장 파일 경로(기본값: ~/.mcp-think-tank/memory.jsonl )
  • EXA_API_KEY ( Exa 웹 검색에 필요 ): exa_searchexa_answer 도구를 활성화합니다.
고급 구성
  • MCP_DEBUG : 디버그 로깅 활성화(기본값: false )
  • MCP_LISTEN_PORT : MCP 서버에 대한 사용자 지정 포트를 설정합니다(기본값: 3399 )
  • LOG_LEVEL : 로깅 수준 설정( debug , info , warn , error ) (기본값: info )
  • AUTO_LINK : 지식 그래프에서 자동 엔터티 연결을 활성화합니다(기본값: true )
새로운 도구 오케스트레이션 및 캐싱 설정
  • TOOL_LIMIT : 세션당 도구 호출의 최대 수(기본값: 25 )
  • CACHE_TOOL_CALLS : 중복 도구 호출 캐싱을 활성화/비활성화합니다(기본값: true )
  • TOOL_CACHE_SIZE : 캐시된 도구 호출의 최대 수(기본값: 100 )
  • CACHE_CONTENT : 파일/URL 작업에 대한 콘텐츠 기반 캐싱을 활성화/비활성화합니다(기본값: true )
  • CONTENT_CACHE_SIZE : 콘텐츠 캐시의 최대 항목 수(기본값: 50 )
  • CONTENT_CACHE_TTL : 캐시된 콘텐츠의 수명(밀리초)(기본값: 300000 - 5분)
메모리 유지 관리
  • MIN_SIMILARITY_SCORE : 엔티티 매칭에 대한 임계값(기본값: 0.85 )
  • MAX_OPERATION_TIME : 일괄 작업의 최대 시간(밀리초) (기본값: 5000 )

고급 설정을 사용한 구성 예:

{ "mcpServers": { "think-tool": { "command": "npx", "args": ["-y", "mcp-think-tank"], "type": "stdio", "env": { "MEMORY_PATH": "./project-memory.jsonl", "EXA_API_KEY": "your-exa-api-key-here", "TOOL_LIMIT": "50", "CACHE_CONTENT": "true", "CONTENT_CACHE_SIZE": "100", "MCP_DEBUG": "false", "AUTO_LINK": "true" } } } }

💡 성능 팁: 대규모 프로젝트의 경우 TOOL_LIMIT 및 캐시 크기를 늘리면 메모리 사용량이 증가하는 대신 성능이 향상될 수 있습니다. 사용 패턴을 모니터링하고 그에 따라 조정하세요.

MCP 서버에 대한 자세한 내용은 커서 MCP 설명서를 참조하세요.

벌채 반출

MCP Think Tank는 FastMCP 및 프로덕션 모범 사례에 맞게 설계된 최소한의 안정적인 로깅 방식을 사용합니다.

  • 로그는 ~/.mcp-think-tank/logs/mcp-think-tank.log 에 있는 단일 파일에 기록됩니다.
  • 로그를 쓰기 전에 파일 크기를 확인합니다. 크기가 10MB를 초과하면 로그 파일 이름을 타임스탬프로 변경하고 새 파일을 시작합니다.
  • 로깅에는 Node.js 내장 모듈만 사용됩니다.
  • 디버그 로깅은 환경 변수 MCP_DEBUG=true 설정하여 활성화할 수 있습니다.
  • MCP_LOG_FILE=false 설정하면 파일 로깅을 비활성화할 수 있습니다.

이러한 접근 방식은 핵심 MCP 서버 도구에 초점을 맞추고 불필요한 복잡성을 피하기 위한 것입니다.

📝 MCP 싱크탱크: 프로젝트 규칙 설정

Cursor와 모든 에이전트가 MCP Think Tank의 모든 기능을 사용할 수 있도록 다음과 같이 항상 활성화된 단일 프로젝트 규칙을 만듭니다.

Exa 웹 검색 API 키가 필요합니다

참고: Exa 기반 웹 검색 도구( exa_search , exa_answer )를 사용하려면 Exa API 키를 제공해야 합니다. 이 키가 없으면 웹 검색이 작동하지 않습니다.

  1. API 키 받기: exa.ai 에 가입하고 API 키를 받으세요.
  2. MCP 서버 설정에서 키를 설정하세요. MCP 서버 설정의 env 섹션에 EXA_API_KEY 추가하세요. .cursor/mcp.json 파일의 예:
{ "mcpServers": { "think-tool": { "command": "npx", "args": ["-y", "mcp-think-tank"], "type": "stdio", "env": { "MEMORY_PATH": "/absolute/path/to/your/memory.jsonl", "EXA_API_KEY": "your-exa-api-key-here" } } } }

자세한 내용은 exa.aiCursor MCP 설명서를 참조하세요.

1. 커서에 새 규칙 추가

  1. 커서를 엽니다.
  2. 명령 팔레트( Cmd+Shift+P 또는 Ctrl+Shift+P )로 이동합니다.
  3. "새 커서 규칙"을 선택합니다.
  4. 규칙의 이름을 지정합니다(예: mcp-think-tank.mdc ).
  5. 규칙 편집기에서 아래와 같이 메타데이터를 설정하고 규칙 내용을 붙여넣습니다.

2. 예제 규칙 파일( .cursor/rules/mcp-think-tank.mdc )

--- rule type: auto attach use globs: **/*.js,**/*.ts,**/*.jsx,**/*.tsx,**/*.md,**/*.py,**/*.json --- # MCP Think Tank Tools Guide MCP Think Tank extends AI with structured reasoning, knowledge graph memory, task management, and web research capabilities. This rule helps determine when each tool is most appropriate. ## Tool Selection Guide ### 1. Thinking Tools (Structured Reasoning) Use `think` for: - Complex technical decisions requiring systematic analysis - Architecture planning and design considerations - Step-by-step problem-solving with self-reflection - When analysis should be saved for future reference ```javascript // Complex architecture decision with memory storage mcp_think-tool_think({ structuredReasoning: "Analyzing database options for our user management system...", category: "architecture", storeInMemory: true })

2. 메모리 및 지식 그래프

대화 전반에 걸쳐 정보를 보존해야 하는 경우 사용:

도구언제 사용할 것인가
upsert_entities중요한 개념이나 구성 요소를 문서화하거나 업데이트 플래그를 사용하여 기존 엔터티를 업데이트합니다.
add_observations기존 엔터티에 새로운 사실 추가
create_relations관련 개념 연결
search_nodes문제를 해결하기 전에 관련 지식을 찾아보세요
open_nodes특정 엔터티 세부 정보 검색
// Documenting architectural components mcp_think-tool_upsert_entities({ entities: [ {name: "AuthService", entityType: "System", observations: ["Handles authentication"]} ] })

3. 작업 관리

프로젝트 계획 및 추적에 사용:

  • plan_tasks : 프로젝트 시작 시 또는 기능 계획 시
  • list_tasks : 현재 작업 상태를 파악하기 위해
  • next_task : 다음 우선순위 작업을 할 준비가 되었을 때
  • complete_task : 작업이 완료될 때
  • update_tasks : 우선순위가 변경될 때

4. 웹 리서치(Exa)

현재 맥락이 충분하지 않을 때 사용하세요:

  • exa_search : 웹에서 최신 정보를 찾는 데 사용
  • exa_answer : 인용된 출처가 필요한 사실 관련 질문의 경우
// Research current best practices mcp_think-tool_exa_search({ query: "latest React state management libraries 2025", num_results: 5 })

통합 모범 사례

  1. think Tool로 복잡한 추론을 시작하세요
  2. 중요한 결론을 지식 그래프에 저장
  3. 적절한 경우 결론에 따라 작업을 생성합니다.
  4. 연구 도구를 사용하여 지식 격차를 메우세요
  5. 지식 그래프에 연구 결과 기록

성능 고려 사항

  • 도구 호출은 세션당 25개로 제한됩니다(구성 가능)
  • 콘텐츠 캐싱은 반복되는 파일/URL 작업의 성능을 향상시킵니다.
  • 최적의 성능을 위해 중복 도구 호출을 피하세요
### 2. Memory & Knowledge Graph Use when information should be preserved across conversations: | Tool | When to Use | |------|-------------| | `upsert_entities` | Document important concepts or components or update existing entities with the update flag | | `add_observations` | Add new facts to existing entities | | `create_relations` | Connect related concepts | | `search_nodes` | Find relevant knowledge before solving problems | | `open_nodes` | Retrieve specific entity details | ```javascript // Documenting architectural components mcp_think-tool_upsert_entities({ entities: [ {name: "AuthService", entityType: "System", observations: ["Handles authentication"]} ] })

3. 작업 관리

프로젝트 계획 및 추적에 사용:

  • plan_tasks : 프로젝트 시작 시 또는 기능 계획 시
  • list_tasks : 현재 작업 상태를 파악하기 위해
  • next_task : 다음 우선순위 작업을 할 준비가 되었을 때
  • complete_task : 작업이 완료될 때
  • update_tasks : 우선순위가 변경될 때

4. 웹 리서치(Exa)

현재 맥락이 충분하지 않을 때 사용하세요:

  • exa_search : 웹에서 최신 정보를 찾는 데 사용
  • exa_answer : 인용된 출처가 필요한 사실 관련 질문의 경우
// Research current best practices mcp_think-tool_exa_search({ query: "latest React state management libraries 2025", num_results: 5 })

통합 모범 사례

  1. think Tool로 복잡한 추론을 시작하세요
  2. 중요한 결론을 지식 그래프에 저장
  3. 적절한 경우 결론에 따라 작업을 생성합니다.
  4. 연구 도구를 사용하여 지식 격차를 메우세요
  5. 지식 그래프에 연구 결과 기록

성능 고려 사항

  • 도구 호출은 세션당 25개로 제한됩니다(구성 가능)
  • 콘텐츠 캐싱은 반복되는 파일/URL 작업의 성능을 향상시킵니다.
  • 최적의 성능을 위해 중복 도구 호출을 피하세요
## 📝 How To Save Important Thoughts When using the `think` tool with important reasoning, you have several options to enhance and persist your thought processes: ### Saving Thoughts to Memory Simply tell the agent "Please save this reasoning in memory for future reference" and the tool will automatically save the reasoning in the knowledge graph with `storeInMemory: true`. ### Multi-Step Reasoning For complex problems that require sequential thinking: 1. Break down your reasoning into logical steps 2. Use the step counter parameters (`plannedSteps` and `currentStep`) to track progress 3. The system will maintain continuity across multiple reasoning steps 4. Each step is saved with appropriate metadata when stored in memory Example request: "Let's analyze this architecture decision in 4 steps. This is step 1 focusing on requirements. Please save this in memory." ### Self-Reflection Enhancement Improve the quality of your reasoning with automated self-reflection: 1. Request self-reflection by saying "Please analyze this reasoning and provide a reflection on potential improvements" 2. The system will evaluate your reasoning for logical gaps, overlooked factors, and potential improvements 3. Both the original reasoning and reflection are stored together in memory 4. Use custom reflection prompts for targeted improvement in specific areas Example request: "Please reflect on this architecture decision with a focus on security considerations I might have missed, and save the analysis to memory." ### Research Integration Seamlessly incorporate web research into your reasoning process: 1. Include research queries in your thinking with `[research: your query]` syntax 2. Request initial research with "Before analyzing this problem, please research the latest approaches to X" 3. All research results are automatically formatted with source citations 4. Research sources are added as relations in the knowledge graph Example request: "I need to understand [research: latest React state management approaches 2023] before making this architecture decision. Please save this analysis in memory." ## 🧠 Think Tank Instructions This section provides detailed, actionable guidance for using MCP Think Tank within Cursor AI IDE (or any MCP-compliant agent), with a focus on coding and large project development. The tools are grouped into four main categories: ### 1. Think Tools (Structured Reasoning) - Use the `think` tool for all complex decisions, architecture planning, and problem-solving. - Always provide clear, step-by-step reasoning and relevant context. - **To persist your reasoning for future reference, set `storeInMemory: true` in your tool call.** - Example: When you want your analysis or decision to be available across sessions or for team traceability. - If you do not set `storeInMemory: true`, your reasoning will be processed but not saved in the knowledge graph. - Agents (like Cursor or Claude) can be prompted to "save this reasoning in memory" to ensure persistence. - You can later retrieve saved thoughts using the `search_nodes` or `open_nodes` tools. #### How `storeInMemory` Works - The `think` tool accepts a `storeInMemory` parameter (default: false). - When `storeInMemory: true`, your structured reasoning, context, and tags are saved as an entity in the knowledge graph. - This enables robust project memory, traceability, and continuity. - Example tool call: ```json { "tool": "think", "parameters": { "structuredReasoning": "Analyzed the pros and cons of REST vs GraphQL for our new API. Decided REST is simpler for our use case.", "context": "API design meeting 2024-07-10", "category": "architecture", "tags": ["api", "meeting"], "storeInMemory": true } }
  • 저장된 생각을 검색하려면 다음을 사용하세요.
    • search_nodes (키워드, 태그 또는 컨텍스트 기준)
    • open_nodes (엔터티 이름별)
걸음 수 카운터를 활용한 다단계 추론
  • 여러 단계에 걸쳐 복잡한 사고 과정의 경우, 단계 카운터 매개변수를 사용하세요.
    • plannedSteps : 완료할 계획인 총 단계 수(예: 5)
    • currentStep : 현재 진행 중인 단계 번호(예: 2)
  • 시스템은 여러 단계의 추론 과정을 통해 진행 상황을 추적합니다.
  • storeInMemory: true 사용하면 각 단계가 적절한 메타데이터와 함께 저장됩니다.
  • 도구 호출 예:
    { "tool": "think", "parameters": { "structuredReasoning": "Step 2 analysis of database schema options...", "plannedSteps": 5, "currentStep": 2, "storeInMemory": true } }
  • 이 기능은 복잡한 문제를 관리 가능한 단계로 나누고 진행 상황을 추적하는 데 특히 유용합니다.
추론 강화를 위한 자기 성찰
  • 자기 반성 기능을 사용하여 추론을 자동으로 비판하고 잠재적인 개선 사항을 식별하세요.
  • 이 기능을 활성화하려면 Think 도구 매개변수에서 selfReflect: true 설정하세요.
  • 선택적으로 reflectPrompt 사용하여 사용자 정의 반사 프롬프트를 제공할 수 있습니다.
  • 자기성찰은 다음을 식별하는 데 도움이 됩니다.
    • 추론의 잠재적인 논리적 오류 또는 불일치
    • 간과된 요소 또는 고려 사항
    • 검증이 필요할 수 있는 가정
    • 추론을 강화할 수 있는 영역
  • 자기 반성을 통한 도구 호출 예시:
    { "tool": "think", "parameters": { "structuredReasoning": "My analysis of the authentication system...", "selfReflect": true, "reflectPrompt": "Evaluate my reasoning for security considerations I might have missed", "storeInMemory": true } }
  • storeInMemory: true 사용하면 반사가 원래 추론에 추가되어 함께 저장됩니다.
인라인 연구 통합
  • think 도구 매개변수에서 allowResearch: true 설정하여 중간 추론 연구를 활성화합니다.
  • [research: your search query] 형식을 사용하여 추론에 직접 연구 쿼리를 삽입하세요.
  • 시스템은 자동으로 다음을 수행합니다.
    • 이러한 연구 요청을 감지하고 처리합니다.
    • 마커를 서식이 지정된 연구 결과로 교체합니다.
    • 각 결과에 대한 출처 인용을 포함합니다.
  • 추론을 시작하기 전에 예비 조사를 위한 초기 researchQuery 매개변수를 설정할 수도 있습니다.
  • 연구를 통한 도구 호출 예시:
    { "tool": "think", "parameters": { "structuredReasoning": "I need to understand the latest advancements in [research: quantum error correction 2023] before designing our system.", "allowResearch": true, "storeInMemory": true } }
  • 여러 연구 요청을 단일 추론 단계에 포함할 수 있습니다.
  • storeInMemory: true 사용하면 모든 연구 결과와 출처가 추론과 함께 저장됩니다.
  • 연구 소스는 추적성을 위해 지식 그래프에 관계로 추가됩니다.
구조화된 마크다운 서식
  • Think 도구는 가독성을 높이기 위해 자동으로 출력을 구조화된 마크다운으로 포맷합니다.
  • 사용 가능한 형식 유형:
    • general : 서론, 분석, 결론 섹션이 포함된 일반적인 추론
    • problem : 문제 정의, 분석 및 솔루션 섹션이 포함된 문제 해결 형식
    • comparison : 표를 보존하고 옵션을 강조하는 비교 분석 형식
  • 다음 매개변수를 사용하여 서식을 제어합니다.
    • formatOutput: true/false - 서식을 활성화하거나 비활성화합니다(기본값: true)
    • formatType: 'auto'/'general'/'problem'/'comparison' - 형식 유형을 선택합니다(기본값: auto)
  • formatType 이 'auto'인 경우 시스템은 가장 적합한 형식을 결정하기 위해 콘텐츠를 분석합니다.
  • 특정 형식을 사용한 도구 호출 예:
    { "tool": "think", "parameters": { "structuredReasoning": "My analysis comparing different database options...", "formatType": "comparison", "storeInMemory": true } }
  • 형식화된 출력에는 다음이 포함됩니다.
    • 섹션 헤더 지우기
    • 컨텍스트와 카테고리가 포함된 메타데이터 섹션
    • 활성화된 기능(반성, 연구)을 보여주는 기능 섹션
    • 형식 유형에 따라 적절하게 구성된 콘텐츠
  • 이 형식은 인간의 가독성과 추론의 기계 구문 분석을 모두 향상시킵니다.

⚠️ 중요: storeInMemory 매개변수는 사용자가 적극적으로 사용하지 않습니다. 사용자는 단순히 "나중에 참조할 수 있도록 이 추론을 메모리에 저장하세요"라고 쓰기만 하면 도구가 지식 그래프에 추론을 저장합니다.

2. 연구 도구

  • 웹 검색에는 exa_search 사용하고, 출처가 명확한 답변에는 exa_answer 사용하세요.
  • 항상 출처를 인용하고, 관련이 있는 경우 add_observations 사용하거나 think 항목을 저장하여 메모리에 결과를 요약하세요.
  • 연구 도구를 사용하려면 MCP 서버 구성에 유효한 EXA_API_KEY 필요합니다.
  • 연구 결과를 코드와 추론에 통합하여 견고하고 최신 솔루션을 개발하세요.
  • 더 나은 성능을 위해 JSON이 아닌 응답에 대한 지능형 오류 처리와 콘텐츠 캐싱이 포함됩니다.

3. 작업 관리자 도구

  • plan_tasks 사용하여 프로젝트 작업을 만들고 구성합니다.
  • list_tasks , next_task , complete_task , update_tasks 사용하여 워크플로를 관리합니다.
  • 모든 작업은 지식 그래프와 동기화되어 지속적이고 쿼리 가능한 프로젝트 관리가 가능합니다.
  • 대규모 프로젝트의 경우, 작업 종속성과 우선순위를 활용하여 명확성과 추진력을 유지하세요.

4. 메모리 도구

  • upsert_entities , add_observations , create_relations 및 관련 도구를 사용하여 프로젝트의 지식 그래프를 구축하고 유지 관리합니다.
  • 향후 참조를 위해 주요 결정 사항, 재사용 가능한 패턴, 아키텍처 선택을 저장합니다.
  • 새로운 작업을 시작하기 전에 관련 사전 지식을 검색하여 중복을 피하고 과거의 통찰력을 활용하세요.
  • 파일 및 URL 작업은 성능 향상을 위해 콘텐츠 기반 캐싱의 이점을 얻습니다.

⚡ 성능 최적화

MCP Think Tank에는 기본 제공 성능 최적화 기능이 포함되어 있습니다.

콘텐츠 캐싱

  • 암호화 해싱을 기반으로 파일 및 URL 콘텐츠의 자동 캐싱
  • 중복된 파일 읽기 및 네트워크 요청을 방지합니다.
  • 테스트에서 캐시된 URL 페치는 초기 페치보다 1000배 이상 더 빨랐습니다.
  • 파일 읽기는 후속 읽기에서 2~5배 속도 향상으로 상당한 개선을 보였습니다.
  • 캐시 크기와 TTL은 환경 변수를 통해 구성할 수 있습니다.

도구 호출 최적화

  • 동일한 도구 호출은 중복을 제한에 포함시키지 않도록 자동으로 캐시됩니다.
  • 특히 Exa 검색을 위한 지능형 오류 처리 기능은 JSON이 아닌 응답으로 인한 실패를 방지합니다.
  • 도구 제한 보호 장치는 우아한 저하를 제공하는 동시에 폭주하는 도구 사용을 방지합니다.

🛡️ 도구 오케스트레이션 및 보호

MCP Think Tank v2.0.2에는 책임감 있고 효율적인 사용을 보장하기 위한 포괄적인 도구 관리 기능이 포함되어 있습니다.

사용 제한 및 모니터링

  • 기본 제한 : 세션당 25개 도구 호출( TOOL_LIMIT 환경 변수를 통해 구성 가능)
  • 자동 추적 : 모든 도구 호출은 타임스탬프, 에이전트 ID 및 매개변수와 함께 기록됩니다.
  • 우아한 저하 : 한계에 도달하면 시스템은 완전히 실패하는 대신 부분적인 결과를 반환합니다.
  • 상태 추적 : 제한을 초과하는 도구 호출은 HALTED_LIMIT 상태로 태그 지정됩니다.

지능형 캐싱

  • 중복 감지 : 동일한 도구 호출이 자동으로 감지되어 캐시에서 제공됩니다.
  • 콘텐츠 해싱 : 파일 및 URL 작업은 SHA-1 해싱을 사용하여 변경되지 않은 콘텐츠를 식별합니다.
  • 구성 가능한 캐싱 : 환경 변수를 통해 캐싱 동작을 활성화/비활성화합니다.
  • 캐시 통계 : 성능 분석을 위해 캐시 적중률/누락률 모니터링

도구 접근 제어

  • 구성 가능한 허용 목록 : 특정 컨텍스트에서 사용할 수 있는 도구를 제한합니다.
  • 권한 오류 : 허용되지 않는 도구가 요청될 때 오류 메시지를 지웁니다.
  • 오케스트레이션 전략 : 순차적 또는 병렬 실행을 위한 다중 조정 전략
  • 에이전트 격리 : 교차 오염을 방지하기 위해 에이전트별 도구 사용량 추적

구현

보호 장치는 모든 도구 호출을 래핑하는 전용 ToolManager 를 통해 구현됩니다.

  • 원자 카운터는 동시 환경에서도 정확한 추적을 보장합니다.
  • LRU 캐시는 메모리 효율성을 유지하면서 중복 작업을 방지합니다.
  • 포괄적인 오류 처리로 난해한 실패가 아닌 의미 있는 피드백을 제공합니다.
  • 모든 제한 및 캐싱 동작은 코드 변경 없이 구성 가능합니다.

🔒 보안 참고 사항: 도구 오케스트레이션 시스템은 프롬프트가 과도한 도구 사용을 강제로 시도하더라도 구성에 따라 정상적으로 제한되도록 보장합니다.


커서/클로드 및 대규모 프로젝트를 위한 모범 사례:

  • 사소하지 않은 모든 추론에 대해 think 도구를 자유롭게 사용하고 중요한 생각은 항상 기억해 두세요.
  • 원활한 프로젝트 개발을 위해 연구 및 작업 관리를 코딩 워크플로에 통합하세요.
  • 프로젝트 메모리를 관련성 있고 실행 가능하게 유지하려면 지식 그래프를 정기적으로 검토하고 업데이트하세요.
  • 일관되고 고품질의 코드를 위해 이전의 결정과 패턴을 참조하고 이를 기반으로 구축합니다.
  • 복잡한 워크플로에서는 도구 제한을 염두에 두고 캐시 통계 유틸리티를 사용하여 사용량을 모니터링하세요.

새로운 도구나 워크플로가 추가되면 이 섹션을 최신 상태로 유지하세요.

3. 참조 링크

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

  1. 저장소를 포크하세요
  2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
  3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
  4. 브랜치에 푸시( git push origin feature/amazing-feature )
  5. 풀 리퀘스트 열기

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

📚 관련 프로젝트

📚 추가 자료


You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

구조화된 사고, 지속적인 지식 그래프 메모리, 복잡한 문제 해결을 위한 지능형 도구 오케스트레이션을 통해 AI 보조원의 추론 기능을 향상시킵니다.

  1. 개요
    1. 🎯 철학
      1. 🧠 구조적 사고의 힘
        1. 🚀 주요 특징
          1. 순차적 사고와 연쇄 추론
          2. 향상된 지식 그래프 메모리
          3. 도구 오케스트레이션 및 보호
        2. 📦 설치
          1. NPX (추천)
          2. 글로벌 설치
        3. ⚙️ 구성
          1. 빠른 시작: 필수 설정
          2. 환경 변수
        4. 벌채 반출
          1. 📝 MCP 싱크탱크: 프로젝트 규칙 설정
            1. Exa 웹 검색 API 키가 필요합니다
            2. 1. 커서에 새 규칙 추가
            3. 2. 예제 규칙 파일( .cursor/rules/mcp-think-tank.mdc )
            4. 2. 메모리 및 지식 그래프
            5. 3. 작업 관리
            6. 4. 웹 리서치(Exa)
          2. 통합 모범 사례
            1. 성능 고려 사항
              1. 3. 작업 관리
              2. 4. 웹 리서치(Exa)
            2. 통합 모범 사례
              1. 성능 고려 사항
                1. 걸음 수 카운터를 활용한 다단계 추론
                2. 추론 강화를 위한 자기 성찰
                3. 인라인 연구 통합
                4. 구조화된 마크다운 서식
                5. 2. 연구 도구
                6. 3. 작업 관리자 도구
                7. 4. 메모리 도구
              2. ⚡ 성능 최적화
                1. 콘텐츠 캐싱
                2. 도구 호출 최적화
              3. 🛡️ 도구 오케스트레이션 및 보호
                1. 사용 제한 및 모니터링
                2. 지능형 캐싱
                3. 도구 접근 제어
                4. 구현
                5. 3. 참조 링크
              4. 🤝 기여하기
                1. 📄 라이센스
                  1. 📚 관련 프로젝트
                    1. 📚 추가 자료

                      Related MCP Servers

                      • A
                        security
                        F
                        license
                        A
                        quality
                        Provides reasoning content to MCP-enabled AI clients by interfacing with Deepseek's API or a local Ollama server, enabling focused reasoning and thought process visualization.
                        Last updated -
                        1
                        54
                        24
                        JavaScript
                      • A
                        security
                        A
                        license
                        A
                        quality
                        A server that enhances Claude's reasoning capabilities by integrating DeepSeek R1's advanced reasoning engine to tackle complex reasoning tasks.
                        Last updated -
                        1
                        Python
                        MIT License
                        • Apple
                      • A
                        security
                        A
                        license
                        A
                        quality
                        Enhances AI model capabilities with structured, retrieval-augmented thinking processes that enable dynamic thought chains, parallel exploration paths, and recursive refinement cycles for improved reasoning.
                        Last updated -
                        1
                        4
                        JavaScript
                        MIT License
                      • A
                        security
                        A
                        license
                        A
                        quality
                        AoT MCP server enables AI models to solve complex reasoning problems by decomposing them into independent, reusable atomic units of thought, featuring a powerful decomposition-contraction mechanism that allows for deep exploration of problem spaces while maintaining high confidence in conclusions.
                        Last updated -
                        3
                        14
                        JavaScript
                        MIT License

                      View all related MCP servers

                      ID: pgg03wdx49