Stellar Jay MCP sunucusu
Commit 30 Eki 2026Yapay zeka ajanlarının, ajana özgü bir veri deposu kullanarak şirket verileri üzerinde versiyonlanmış, ilişkilendirilmiş ve geri alınabilir iş süreçleri yürütmesini sağlar.
Ayrıca bilinen adı kyle-visner/stellarjay, stellarjay
- Yıldızlar
- 9
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.7.1
- Son commit
- 30 Eki 2026
- Lisans
- AGPL-3.0
Stellar Jay MCP nedir?
Yapay zeka ajanlarının, ajana özgü bir veri deposu kullanarak şirket verileri üzerinde versiyonlanmış, ilişkilendirilmiş ve geri alınabilir iş süreçleri yürütmesini sağlar.
Özet, projenin README dosyasından oluşturuldu
Stellar Jay MCP sunucusu hakkında
AvianSuite, salt okunur copilots yapılarından aktif ajanlara geçmek isteyen geliştiriciler ve küçük ekipler için tasarlanmış, ajana özgü bir iş verisi platformu sunar. Yapay zeka ajanlarının muhasebe veya satış takibi gibi görevleri yerine getirmesine olanak tanırken, her değişikliğin versiyonlanmasını ve belirli bir ajana atanmasını sağlamak için Stellar Jay veri deposunu kullanır. Bu yapı, iş verileri için Git gibi çalışır; yani hiçbir bilgi asla üzerine yazılmaz veya silinmez ve her değişiklik geri alınabilir.
Kullanıcılar, hizmete AvianSuite üzerinden mağabaşına her ay 20 $ karşılığında barındırılan bir sürümle veya açık kaynaklı yazılımı AGPL lisansı altında kendi sunucularına kurarak erişebilirler. Bir ajanı bağlamak için Claude Code, Cursor veya Claude ve ChatGPT içindeki özel konnektörler aracılığıyla MCP server kullanabilirsiniz. Kendi sunucunuza kurduğunuz kurulumlar, yerel veya uzak veri deposuyla güvenli iletişimi yönetmek için stellarjay-mcp komutuna ve STELLARJAY_URL ile STELLARJAY_TOKEN gibi belirli ortam değişkenlerine ihtiyaç duyar.
Neler yapabilirsiniz
- 1Ajan hatalarını geri almaBir yapay zeka ajanı hatalı bir işlem yaparsa, belirli bir zaman aralığında yaptığı tüm değişiklikleri geri alabilir.
- 2Ajan faaliyetlerini denetlemeGeliştiriciler, hangi ajanın belirli bir veri parçasını tam olarak ne zaman değiştirdiğini takip edebilirler.
- 3Veri bozulmasını önlemeSistem, ajanların yeniden denemeler sırasında mükerrer kayıtlar oluşturmasını veya güncel olmayan bilgilere dayanarak veri yazmasını engeller.
- 4Esnek iş kayıtlarını yönetmeKarmaşık veritabanı migrasyonları yapmanıza gerek kalmadan iş verilerinize yeni alanlar ekleyebilirsiniz.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Stellar Jay MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleStellar Jay MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcpStellar Jay MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp"
}
}
}Stellar Jay MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"stellarjay": {
"type": "http",
"url": "https://mcp.aviansuite.com/mcp"
}
}
}Stellar Jay MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"stellarjay","type":"http","url":"https://mcp.aviansuite.com/mcp"}'Stellar Jay MCP'yi Codex içine yükleyin
$ codex mcp add stellarjay --url https://mcp.aviansuite.com/mcpStellar Jay MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.stellarjay] url = "https://mcp.aviansuite.com/mcp"
Stellar Jay MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http stellarjay https://mcp.aviansuite.com/mcpStellar Jay MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp",
"type": "http"
}
}
}Yapılandırma
STELLARJAY_AUTH_FILESTELLARJAY_DATA_DIRSTELLARJAY_DATA_KEY_FILESTELLARJAY_TOKENSTELLARJAY_URL
| Ad | Açıklama | Sunucu |
|---|---|---|
| STELLARJAY_AUTH_FILE | — | |
| STELLARJAY_DATA_DIR | — | |
| STELLARJAY_DATA_KEY_FILE | — | |
| STELLARJAY_TOKEN | — | |
| STELLARJAY_URL | — |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirkyle-visner/stellarjay is public and reachablegithub.com/kyle-visner/stellarjay ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-30github.com/kyle-visner/stellarjay ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorHTTPS endpoint answered 401 (sign-in required)Geçti
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 soruları
Stellar Jay MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Stellar Jay MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Ajanların verilerimi üzerine yazmasını veya silmesini nasıl engelleyebilirim?
Sistem, hiçbir verinin üzerine yazılmayacak veya silinmeyecek şekilde tasarlanmıştır; düzeltmeler yeni girişler olarak kaydedilir ve orijinal veri geçmişte kalır.
Bir yapay zeka ajanı tarafından yapılan değişiklikleri geri alabilir miyim?
Evet, belirli bir ajanın belirli bir zaman aralığında yaptığı tüm değişiklikleri, geri alma işlemini önce önizleme seçeneğiyle birlikte geri alabilirsiniz.
Belirli bir değişikliği hangi ajanın yaptığını nasıl anlarım?
Her değişiklik, kendi token'ı aracılığıyla belirli bir ajana atanır; böylece kimin, neyi, ne zaman değiştirdiğini tam olarak görebilirsiniz.