Skip to main content
Glama
deenesjakoruzh
soluai-spa

solucortex-mcp

Official
by soluai-spa
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

SoluCortex MCP

AI 에이전트를 위한 살아있는 기술 메모리 — SoluCortex — 의 공식 Model Context Protocol 서버입니다.

MCP 호환 에이전트(Claude Code, Claude Desktop, Cursor, Codex, Cline, …)를 SoluCortex 프로젝트에 연결하면, 작업을 시작하기 전에 중요한 결정, 규칙, 위험 및 아키텍처를 상기하고 작업이 끝나면 배운 내용을 기억할 수 있습니다.

도구

도구

기능

사용 시점

solucortex_recall

작업을 위한 살아있는 컨텍스트 구축(의미적 유사성 + 중요도 기준 순위)

코드를 건드리기 전, 작업 시작 시

solucortex_search

프로젝트 메모리에 대한 임시 의미적 검색

작업 중 특정 질문이 있을 때

solucortex_remember

메모리 기록(approved로 저장 + 인가된 에이전트로 추적)

작업 종료 시 또는 관련 기술 결정 시

solucortex_list_memories

의미적 검색 없이 메모리 나열

빠른 확인 / 감사

Related MCP server: Muninn

요구 사항

  • SoluCortex 계정과 프로젝트 API 키(접두사 scx_) — SoluCortex 대시보드에서 받을 수 있습니다.

  • 다음 중 하나: uv(권장), Python ≥ 3.10 또는 Docker.

구성

stdio 모드(기본, 로컬)

서버는 전적으로 환경 변수를 통해 구성됩니다:

변수

필수 여부

설명

SOLUCORTEX_API_KEY

✅

프로젝트 API 키 (scx_…)

SOLUCORTEX_PROJECT_ID

권장

기본 프로젝트 UUID(호출별로 재정의 가능)

SOLUCORTEX_URL

선택

API 기본 URL. 기본값 https://solucortex.ai

HTTP 모드(원격, 다중 테넌트)

MCP_TRANSPORT=http(또는 --http)로 실행하면 $PORT(기본값 8080)에서 Streamable HTTP를 제공합니다 — https://mcp.solucortex.ai에서 사용되는 모드입니다. 자격 증명은 각 요청과 함께 전달되며 환경 변수는 무시됩니다:

헤더

필수 여부

설명

Authorization: Bearer scx_…

✅

호출자의 프로젝트 API 키(없으면 401)

X-Solucortex-Project

권장

세션의 기본 프로젝트 UUID

GET /health(로컬에서는 /healthz; Cloud Run 프론트엔드가 /healthz를 가로챔)는 인증 없이 응답합니다. MCP 엔드포인트는 /mcp이며 상태를 유지하지 않고 요청/테넌트 간에 아무것도 공유하지 않습니다.

API 키를 커밋하지 마세요. MCP 클라이언트 구성의 env 블록이나 로컬 .env 파일에 보관하세요(.env.example 참조).

설치

원격(권장 — 설치 불필요)

https://mcp.solucortex.ai/mcp의 호스팅 서버는 Streamable HTTP를 사용하며, 키는 각 요청과 함께 전달됩니다:

claude mcp add --transport http solucortex https://mcp.solucortex.ai/mcp \
  --header "Authorization: Bearer scx_xxx" \
  --header "X-Solucortex-Project: your-project-uuid"

또는 원격 MCP를 지원하는 모든 클라이언트에서:

{
  "mcpServers": {
    "solucortex": {
      "type": "http",
      "url": "https://mcp.solucortex.ai/mcp",
      "headers": {
        "Authorization": "Bearer scx_xxx",
        "X-Solucortex-Project": "your-project-uuid"
      }
    }
  }
}

Claude Code(로컬, stdio)

claude mcp add solucortex \
  -e SOLUCORTEX_API_KEY=scx_xxx \
  -e SOLUCORTEX_PROJECT_ID=your-project-uuid \
  -- uvx --from git+https://github.com/soluai-spa/solucortex-mcp solucortex-mcp

(PyPI에 게시된 후에는 명령어를 uvx solucortex-mcp로 바꾸세요.)

Claude Desktop / Cursor / Cline(JSON 구성)

클라이언트의 MCP 구성(claude_desktop_config.json, Cursor mcp.json 등)에 추가하세요:

{
  "mcpServers": {
    "solucortex": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/soluai-spa/solucortex-mcp", "solucortex-mcp"],
      "env": {
        "SOLUCORTEX_API_KEY": "scx_xxx",
        "SOLUCORTEX_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

로컬 클론에서

git clone https://github.com/soluai-spa/solucortex-mcp
cd solucortex-mcp
cp .env.example .env   # fill in your key
./run.sh               # loads .env, then runs via uv
# or, with SOLUCORTEX_* already exported: uv run solucortex-mcp

Docker

docker build -t solucortex-mcp .
docker run --rm -i \
  -e SOLUCORTEX_API_KEY=scx_xxx \
  -e SOLUCORTEX_PROJECT_ID=your-project-uuid \
  solucortex-mcp

서버는 stdio를 통해 MCP로 통신하므로, 클라이언트는 이를 하위 프로세스로 실행합니다(-i는 stdin을 열어 둡니다).

개발

uv sync
uv run solucortex-mcp            # run (stdio)
MCP_TRANSPORT=http uv run solucortex-mcp   # run (HTTP on :8080)
uv run pytest                    # test suite
npx @modelcontextprotocol/inspector uv run solucortex-mcp   # interactive test

참고 사항

  • 메모리 type 어휘: 정식 집합은 architecture, decision, risk, convention, bug_history, tech_debt, sensitive_module, learning, external_integration입니다. 일부 백엔드는 이전 집합(technical_decision, historical_bug, current_state, task_closure)을 허용합니다. 서버는 type을 그대로 전달하고 HTTP 422를 반환하므로 다른 집합으로 다시 시도할 수 있습니다.

  • 메모리에 실제 비밀 정보를 저장하지 마세요. 대신 위치, 유형, 심각도 및 취한 조치를 기록하세요.

라이선스

MIT — LICENSE 참조.

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • ContextAtlas

    codefromkarl
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI coding agents to retrieve and manage code context with hybrid search, project memory, and observability via MCP tools.
    29
    MIT

  • mcp-chest-memory

    siosig
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides a persistent, local-first memory for coding agents over MCP, enabling automatic recall and recording of past work, failures, and decisions to reduce repetition and token usage.
    MIT

  • apex-memory

    JJerryChoi
    A
    license
    Not graded
    quality
    C
    maintenance
    Persistent memory for AI coding agents. Enables agents to save and recall decisions, patterns, bugs, and context across sessions via an MCP server with local SQLite storage.
    45
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • XMemo

    Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

  • mcp

    Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.

  • Sprintra

    The project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/soluai-spa/solucortex-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server