Stellar Jay MCP server
2026년 10월 30일 커밋에이전트 네이티브 데이터 스토어를 사용하여 AI 에이전트가 기업 데이터에 대해 버전 관리, 속성 부여 및 되돌리기가 가능한 비즈니스 프로세스를 수행할 수 있도록 합니다.
다른 이름 kyle-visner/stellarjay, stellarjay
- 스타
- 9
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.7.1
- 마지막 커밋
- 2026년 10월 30일
- 라이선스
- AGPL-3.0
Stellar Jay MCP란?
에이전트 네이티브 데이터 스토어를 사용하여 AI 에이전트가 기업 데이터에 대해 버전 관리, 속성 부여 및 되돌리기가 가능한 비즈니스 프로세스를 수행할 수 있도록 합니다.
프로젝트 README에서 생성된 요약
Stellar Jay MCP server 정보
AvianSuite는 읽기 전용 코파일럿에서 능동적인 에이전트로 전환하고자 하는 개발자와 소규모 팀을 위해 설계된 에이전트 네이티브 비즈니스 데이터 플랫폼입니다. Stellar Jay 데이터 스토어를 사용하여 AI 에이전트가 회계 처리나 영업 후속 조치와 같은 작업을 수행할 수 있도록 지원하며, 모든 수정 사항이 버전별로 관리되고 특정 에이전트의 속성으로 기록되도록 보장합니다. 이 구조는 비즈니스 데이터에 대한 Git처럼 작동하므로 정보가 절대 덮어쓰여지거나 삭제되지 않으며 모든 변경 사항을 되돌릴 수 있습니다.
사용자는 AvianSuite에서 스토어당 월 $20의 비용으로 호스팅 버전을 이용하거나, AGPL 라이선스에 따라 오픈 소스 소프트웨어를 셀프 호스팅할 수 있습니다. 에이전트를 연결하려면 Claude Code, Cursor 또는 Claude 및 ChatGPT의 커스텀 커넥터를 통해 MCP server를 사용할 수 있습니다. 셀프 호스팅 설정의 경우, 로컬 또는 원격 스토어와의 보안 통신을 관리하기 위해 stellarjay-mcp command와 STELLARJAY_URL, STELLARJAY_TOKEN과 같은 특정 환경 변수가 필요합니다.
활용 사례
- 1에이전트 실수 되돌리기AI 에이전트가 잘못된 작업을 수행한 경우 특정 시간 범위 내에서 수행된 모든 변경 사항을 취소할 수 있습니다.
- 2에이전트 활동 감사개발자는 어떤 에이전트가 특정 데이터를 언제 수정했는지 정확하게 추적할 수 있습니다.
- 3데이터 손상 방지시스템은 에이전트가 재시도 과정에서 중복 엔트리를 생성하거나 오래된 정보를 기반으로 데이터를 작성하는 것을 방지합니다.
- 4유연한 비즈니스 기록 관리복잡한 데이터베이스 마이그레이션 없이 비즈니스 팩트에 새로운 필드를 추가할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Stellar Jay MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Stellar Jay MCP 설치
$ claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcpCursor에 Stellar Jay MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp"
}
}
}VS Code에 Stellar Jay MCP 설치
.vscode/mcp.json
{
"servers": {
"stellarjay": {
"type": "http",
"url": "https://mcp.aviansuite.com/mcp"
}
}
}VS Code CLI에 Stellar Jay MCP 설치
$ code --add-mcp '{"name":"stellarjay","type":"http","url":"https://mcp.aviansuite.com/mcp"}'Codex에 Stellar Jay MCP 설치
$ codex mcp add stellarjay --url https://mcp.aviansuite.com/mcpCodex config.toml에 Stellar Jay MCP 설치
~/.codex/config.toml
[mcp_servers.stellarjay] url = "https://mcp.aviansuite.com/mcp"
Gemini CLI에 Stellar Jay MCP 설치
$ gemini mcp add -s user --transport http stellarjay https://mcp.aviansuite.com/mcpGemini settings.json에 Stellar Jay MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp",
"type": "http"
}
}
}구성
STELLARJAY_AUTH_FILESTELLARJAY_DATA_DIRSTELLARJAY_DATA_KEY_FILESTELLARJAY_TOKENSTELLARJAY_URL
| 이름 | 설명 | 유형 |
|---|---|---|
| STELLARJAY_AUTH_FILE | — | |
| STELLARJAY_DATA_DIR | — | |
| STELLARJAY_DATA_KEY_FILE | — | |
| STELLARJAY_TOKEN | — | |
| STELLARJAY_URL | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능kyle-visner/stellarjay is public and reachablegithub.com/kyle-visner/stellarjay ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-30github.com/kyle-visner/stellarjay ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기Stellar Jay
Stellar Jay is the open-source data store that powers AvianSuite. AvianSuite is an agent-native business data platform: AI agents run business processes like sales follow-up and bookkeeping on your company's data, and every change they make is versioned, attributed to the agent that made it, and reversible. Think of it as Git for your business data.
Agents connect over MCP. The server is listed in the MCP registry as
com.aviansuite/stellar-jay, and the CRM (Martin)
and bookkeeping (Magpie) apps run on
the same store. This project was formerly called JayBase.
- Hosted: AvianSuite runs Stellar Jay for you. $20/month per store, with a 14-day free trial.
- Self-hosted: free and open source under the AGPL. The quick start below gets a store running on your machine in a few minutes.
Agent setup
Connect an agent with the MCP server. On AvianSuite, add the remote server:
# Claude Code
claude mcp add --transport http aviansuite https://mcp.aviansuite.com/mcp
// Cursor: .cursor/mcp.json
{"mcpServers": {"aviansuite": {"url": "https://mcp.aviansuite.com/mcp"}}}
In Claude and ChatGPT, add a custom connector with the same URL.
For a self-hosted store, run the local server instead:
{
"mcpServers": {
"aviansuite": {
"command": "stellarjay-mcp",
"env": {"STELLARJAY_URL": "https://store.example.com", "STELLARJAY_TOKEN": "writer-token"}
}
}
}
Install it with go install github.com/kyle-visner/stellarjay/cmd/stellarjay-mcp@latest.
Tools and details: docs/mcp.md.
Why
Clients want agents that do the work, not just read about it. But when an agent writes straight into a CRM or ticketing system, one bad decision or runaway loop can overwrite or delete records, and there is often no way back.
Stellar Jay is built so that can't happen:
- Nothing is overwritten or deleted. A correction or retraction is a new entry, and the original stays in history.
- Every change has a name on it. Each agent gets its own token, so you can see exactly which agent changed what, and when.
- Any change can be undone. Roll back everything one agent did in a time window, with a preview first.
- History is tamper-evident. If anyone rewrites or removes past entries, it shows.
- Retries are safe. An agent that retries after a timeout doesn't create duplicates, and a write based on stale information is refused.
- Your data stays flexible. Facts are JSON, so new fields and new kinds of records need no migrations.
Every fact keeps its evidence and the agent that recorded it, so any wrong one is visible, attributed and correctable.
Who it's for
Developers, consultants, and small teams moving from read-only copilots to agents that are allowed to act: operations, accounting, approvals, support, and other work where the data matters. Each store serves one organization. Many agents and apps can share it.
Quick start (self-hosted)
Requires Go 1.22 or later.
1. Install and create secrets.
go install github.com/kyle-visner/stellarjay/cmd/stellarjay-server@latest
stellarjay-server init ./secrets
init creates a data encryption key and prints an admin, writer, and reader
token once. Save them in a password manager.
2. Start the server.
export STELLARJAY_DATA_DIR=./data
export STELLARJAY_DATA_KEY_FILE=./secrets/data_key
export STELLARJAY_AUTH_FILE=./secrets/auth.json
stellarjay-server serve
It listens on 127.0.0.1:8080.
3. Record a fact. In another terminal:
export STELLARJAY_URL=http://127.0.0.1:8080
export STELLARJAY_TOKEN='the-writer-token'
curl -fsS -X POST "$STELLARJAY_URL/v1/events" \
-H "Authorization: Bearer $STELLARJAY_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: first-fact" \
--data '{
"type": "business.fact",
"entity_id": "customer-42",
"command": "fact assert",
"payload": {"predicate": "primary_contact", "value": "Ada Lovelace"},
"expected_root": ""
}'
expected_root is empty only for the first entry in a new store. After that,
read the current value from GET /v1/root and send it with each write, so a
write based on stale information is refused. The API guide
covers reading history, pagination, named checkpoints, and snapshots.
4. Connect an agent. Point the MCP server at your store:
go install github.com/kyle-visner/stellarjay/cmd/stellarjay-mcp@latest
Then use the self-hosted config from Agent setup with
STELLARJAY_URL=http://127.0.0.1:8080 and your writer token. Agents that don't
use MCP can read $STELLARJAY_URL/llm.txt, which explains how to work with the
store.
Deploy to a server
For a production store with HTTPS, you need a Linux host with Docker Compose, ports 80 and 443 open, and a DNS record pointing a domain at the host.
git clone https://github.com/kyle-visner/stellarjay.git
cd stellarjay
cp .env.example .env
# Edit .env and set STELLARJAY_DOMAIN.
go run ./cmd/stellarjay-server init ./secrets
docker compose up -d --build
curl https://stellarjay.example.com/health/ready
init will not replace existing secrets. The
operations runbook covers backups, token rotation and
upgrades, and the security model covers keys, roles and
hardening. Or skip all of this and use AvianSuite.
Documentation
- llm.md: the guide agents follow to read and write safely
- docs/mcp.md: MCP server setup and tools
- docs/how-it-works.md: storage model, deployment and the embedded Go library
- docs/api.md: HTTP API reference (OpenAPI)
- docs/architecture.md, docs/security.md, docs/operations.md: running it in production
Development
GOCACHE=/tmp/stellarjay-gocache go test -race ./...
GOCACHE=/tmp/stellarjay-gocache go vet ./...
docker compose config
docker build -t stellarjay:test .
License
AGPL-3.0-or-later. See LICENSE. Hosted Stellar Jay is available from
AvianSuite.
Stellar Jay MCP 질문
Stellar Jay MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Stellar Jay MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
에이전트가 데이터를 덮어쓰거나 삭제하는 것을 어떻게 방지할 수 있나요?
시스템 설계상 데이터가 덮어쓰여지거나 삭제되지 않습니다. 수정 사항은 새로운 엔트리로 기록되며 기존 데이터는 히스토리에 그대로 유지됩니다.
AI 에이전트가 수행한 변경 사항을 취소할 수 있나요?
네, 특정 에이전트가 특정 시간 범위 내에서 수행한 모든 변경 사항을 롤백할 수 있으며, 롤백 전에 미리보기를 수행할 수도 있습니다.
특정 변경을 어떤 에이전트가 수행했는지 어떻게 알 수 있나요?
모든 변경 사항은 고유 토큰을 통해 특정 에이전트의 속성으로 기록되므로, 누가, 무엇을, 언제 변경했는지 정확히 확인할 수 있습니다.