Space Context MCP sunucusu
Commit 28 Eki 2026Yapay zeka asistanlarının, taramaları karşılaştırma ve fotoğraf kanıtlarını görüntüleme dahil olmak üzere, videoya alınmış fiziksel alanlara erişmesine, bunları aramasına ve analiz etmesine olanak tanır.
Ayrıca bilinen adı finikoslab/spacecontext, spacecontext
- Yıldızlar
- 0
- Araçlar
- 13
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.2.1
- Son commit
- 28 Eki 2026
- Lisans
- MIT
Space Context MCP nedir?
Yapay zeka asistanlarının, taramaları karşılaştırma ve fotoğraf kanıtlarını görüntüleme dahil olmak üzere, videoya alınmış fiziksel alanlara erişmesine, bunları aramasına ve analiz etmesine olanak tanır. 13 araç sunar; örneğin list_spaces, search_spaces, get_space.
Özet, projenin README dosyasından oluşturuldu
Space Context MCP sunucusu hakkında
Space Context, videoya alınmış fiziksel ortamların bir yapay zeka asistanı aracılığıyla analiz edilmesini sağlar. Bu uzak MCP server; Claude, ChatGPT, Cursor ve VS Code gibi istemcileri kaydedilmiş alanlarınıza bağlayarak asistanın görsel verileri listelemesine, aramasına ve sorgulamasına imkan tanır. Nesneler, sorunlar ve konumlar hakkında ayrıntılı bilgi sunar; hatta bir bulgunun bağımsız bir fotoğraf kontrolü ile doğrulanıp doğrulanmadığını bile belirtir.
Kullanıcılar, ham anahtarları paylaşmadan erişim yetkilendirmek için Google, Apple veya e-posta ile giriş yaparak OAuth 2.1 üzerinden bağlanırlar. Varsayılan bağlantı salt okunur olsa da, asistanın yeni alanları taramasına veya Wi-Fi şifreleri ile alarm kodları gibi hassas bilgilere erişmesine izin verebilirsiniz. Sunucu Streamable HTTP kullanır ve verilerinizi güvenli bir şekilde yönetmek için Cloudflare Workers üzerinde konuşlandırılabilir.
Basit sorguların ötesinde sunucu, değişiklikleri tespit etmek için farklı taramaları karşılaştırmaya ve orijinal video karelerini fotoğraf kanıtı olarak getirmeye olanak tanır. Tarama geçmişini yönetmek, tarama durumunu kontrol etmek ve hatta tekneler veya beyaz eşyalar gibi belirli ortamların çekimi için kontrol listeleri hazırlamak amacıyla özelleşmiş araçlar içerir.
Neler yapabilirsiniz
- 1Görsel kanıt ile belirli öğeleri bulunBir nesnenin konumunu isteyin ve asistandan orijinal fotoğraf kanıtını göstermesini talep edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Space Context MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleSpace Context MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http spacecontext https://mcp.spacecontext.app/mcpSpace Context MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"spacecontext": {
"url": "https://mcp.spacecontext.app/mcp"
}
}
}Space Context MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"spacecontext": {
"type": "http",
"url": "https://mcp.spacecontext.app/mcp"
}
}
}Space Context MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"spacecontext","type":"http","url":"https://mcp.spacecontext.app/mcp"}'Space Context MCP'yi Codex içine yükleyin
$ codex mcp add spacecontext --url https://mcp.spacecontext.app/mcpSpace Context MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.spacecontext] url = "https://mcp.spacecontext.app/mcp"
Space Context MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http spacecontext https://mcp.spacecontext.app/mcpSpace Context MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"spacecontext": {
"url": "https://mcp.spacecontext.app/mcp",
"type": "http"
}
}
}Space Context MCP araçları 13
README dosyasından algılandılist_spacessearch_spacesget_spaceget_space_markdownask_spaceget_evidence_photowalletcapture_checklistcheck_framecreate_scanupload_framestart_scan
| list_spaces | — | |
| search_spaces | — | |
| get_space | — | |
| get_space_markdown | — | |
| ask_space | — | |
| get_evidence_photo | — | |
| wallet | — | |
| capture_checklist | — | |
| check_frame | — | |
| create_scan | — | |
| upload_frame | — | |
| start_scan | — |
13 aracın tümünü gösterDaha az araç göster
cancel_scan
| cancel_scan | — |
Otomatik kontroller
Çalıştırıldı 14 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şilebilirfinikoslab/spacecontext is public and reachablegithub.com/finikoslab/spacecontext ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-28github.com/finikoslab/spacecontext ↗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 yok13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorHTTPS endpoint answered 401 (sign-in required)Geçti
Space Context MCP server
A remote MCP server that gives Claude, ChatGPT, Codex, Cursor, VS Code or any MCP client access to your Space Context spaces. The assistant can list spaces, search them, read them by section or as one page, ask them questions, compare scans and show the photo evidence. Every item, issue and key location says whether a second, independent check found it on its own photo (verified, unconfirmed or from the narration), so the assistant knows what to state and what to hedge. If you allow it, it can also scan spaces for you.
https://mcp.spacecontext.app/mcp
It speaks MCP over Streamable HTTP and authorizes with OAuth 2.1 (dynamic client registration and client ID metadata documents). It's stateless (createMcpHandler from agents, MCP SDK v2) behind @cloudflare/workers-oauth-provider. This package isn't published to npm. Use the hosted server above, or deploy your own.
Connect an assistant
| Client | How |
|---|---|
| Claude (claude.ai, Desktop) | Settings → Connectors → Add custom connector, paste the URL, Connect |
| Claude Code | claude mcp add --transport http --scope user spacecontext https://mcp.spacecontext.app/mcp, then /mcp → Authenticate |
| Codex | codex mcp add spacecontext --url https://mcp.spacecontext.app/mcp, then codex mcp login spacecontext |
| ChatGPT | Settings → Apps & Connectors → Advanced → Developer mode, then create a connector with the URL and OAuth |
| Cursor | "spacecontext": { "url": "https://mcp.spacecontext.app/mcp" } under mcpServers in ~/.cursor/mcp.json, then Login in Cursor's MCP settings |
| VS Code | code --add-mcp '{"name":"spacecontext","type":"http","url":"https://mcp.spacecontext.app/mcp"}' (or servers in a workspace's .vscode/mcp.json), then MCP: List Servers → start it and sign in |
You never paste a key. Connecting works like this:
- Your assistant opens a Space Context page. You sign in with Apple, Google or a code sent to your email, using the same account as the iPhone app.
- You choose whether the assistant may see sensitive values (Wi-Fi passwords, door and alarm codes, the narration) and whether it may scan spaces for you. By default it can do neither. Scanning needs a card on file in your account (added in the console, nothing charged): without one, the page offers to connect read-only instead, or to try again once the card is added.
- The server creates an API key for this connection only, listed as
MCP · <assistant>in the console. Its scopes arespaces:readandscans:read, plusspaces:sensitiveandscans:writeif you ticked them.
Revoking that key in the console ends the connection, and the assistant asks you to sign in again. Connecting the same assistant again replaces its previous key. The assistant sees your live spaces, including the ones scanned with the iPhone app. A space from the app becomes readable once it has been screened for sensitive values: the first read starts the screening, which takes a minute or two. Full guide: Connect an assistant.
Tools
Reading tools, on every connection (annotated read-only and idempotent):
| Tool | |
|---|---|
list_spaces |
Spaces with their latest scan, 50 per page |
search_spaces |
The records that best answer a question, across all spaces or one, in any language |
get_space |
A space by section (areas, items, issues, key locations, instructions, facts, Q&A, coverage), optionally with evidence |
get_space_markdown |
The whole space as one Markdown page, to load it as context in one call |
ask_space |
A short answer with citations, or documented: false |
list_scans, compare_scans |
The scan history, and what changed between two scans, with evidence from both |
get_evidence_photo |
The original video frame behind a record, as an image |
get_scan_status, follow_scan |
Where a scan is; follow_scan waits on the event stream and reports progress |
wallet |
Balance, free scans left, price of a scan |
capture_checklist |
What to film for a type of space (a flat, a car, a boat, an appliance…), before a scan |
These tools work only on a connection where the user ticked let it scan spaces. On any other connection the API refuses them with INSUFFICIENT_SCOPE:
| Tool | |
|---|---|
check_frame |
Is this photo usable, and which key locations does it show (with space_type, those of that type and the area); nothing is stored or charged |
create_scan |
Declares a scan of an existing or a new space and returns the upload instructions |
upload_frame |
Sends one image of a frames scan through the server, which holds the key |
start_scan |
Starts and charges a scan: the free scan first, then $1.00 from the balance; refunded if it fails |
cancel_scan |
Cancels a scan that hasn't started; nothing is charged |
Resources: spacecontext://spaces (the list, JSON) and spacecontext://spaces/{space_id} (a space as Markdown). Prompts: check_out_report (compare two scans and write a report that keeps confirmed changes apart from what may be missing) and where_is (find one thing, with its area and evidence photo).
No tool reaches the open web. Space content is returned as data, never as instructions: the server's instructions say so, and so does a note in every result that carries space content. The server card at /.well-known/mcp/server-card.json lists tools, resources and prompts before sign-in. Arguments and results: MCP tools.
Deploy your own
The server is a Cloudflare Worker that talks to a Space Context API (…/v1, with API_V1_ENABLED = "true"). It signs people in through the API's own sign-in endpoints and creates one API key per connection. Everything it keeps is in KV: OAuth clients, grants and tokens (grants carry the connection's API key and are encrypted by the OAuth library), and sign-ins in progress, for ten minutes, encrypted with a key that only the user's browser holds.
1. Install and build the SDK (the server imports it), from the repository root:
npm install
npm run build -w @spacecontext/sdk
2. Create the KV namespace for OAuth clients, grants and tokens, and put its id in kv_namespaces in wrangler.jsonc. This and the next steps run in packages/mcp:
cd packages/mcp
npx wrangler kv namespace create OAUTH_KV
3. Set the configuration in wrangler.jsonc (name, the custom domain in routes, and vars):
API_BASE_URL |
The API base, for example https://api.spacecontext.app/v1 |
PUBLIC_URL |
This server's origin. It names the protected resource (/.well-known/oauth-protected-resource/mcp) and is the only origin the consent forms accept posts from |
GOOGLE_WEB_CLIENT_ID |
Optional: the Google web OAuth client for "Continue with Google" |
APPLE_SERVICES_ID |
Optional: the Services ID for "Sign in with Apple" |
BACKEND (services) |
Optional: a service binding to the API Worker. Through it, the API sees each user's own IP for its rate limits and sign-in protection. Without it, the server calls API_BASE_URL over the internet and every user shares the Worker's IP. Remove the entry if the API isn't a Worker in your account |
4. Add the secret for Google sign-in:
npx wrangler secret put GOOGLE_WEB_CLIENT_SECRET
5. Register the callback URLs with the providers:
- Google: add
${PUBLIC_URL}/authorize/google/callbackas an authorized redirect URI of the web OAuth client. - Apple: add
${PUBLIC_URL}/authorize/apple/callbackas a return URL of the Services ID.
Without both GOOGLE_WEB_CLIENT_ID and the secret, the Google button isn't shown, and the same goes for Apple without APPLE_SERVICES_ID. Email sign-in is always offered. The API checks Google and Apple tokens against its own web client ID and Services ID, so use the same ones the API is configured with.
6. Deploy:
npm run deploy # wrangler deploy of the top-level environment
Keep these settings from wrangler.jsonc:
global_fetch_strictly_publicstays on. The server fetches client metadata documents from URLs that clients choose, so a plainfetchmust never reach private addresses. The API is reached through theBACKENDbinding.- With
workers_devandpreview_urlsoff, the server answers only on its custom domain. ratelimitslimit each client IP to 10 registrations (/register) and 60 sign-in page requests (/authorize…) a minute, answered with429andRetry-After: 60beyond. Rate limits aren't inherited by environments, and eachnamespace_idmust be unique in your Cloudflare account. Without the bindings (as indev) nothing is limited.- Access tokens last one hour. A grant lives for 90 days after its last refresh. A client registered dynamically is deleted after 180 days without a token request.
wrangler.jsonc also defines dev (local, see below) and staging (Space Context's own staging deployment).
Develop
npm run dev -w @spacecontext/mcp # http://localhost:8788, against an API on 127.0.0.1:8787
npm test -w @spacecontext/mcp # the full OAuth flow and MCP calls in workerd, against a fake API
The API isn't part of this repository. The tests don't need it: they drive registration, PKCE, consent, token and real MCP calls against a fake API. The dev environment sets no Google or Apple client, so local sign-in uses the emailed code. Read CONTRIBUTING.md before adding a tool: any tool that writes or spends must sit behind scans:write and be annotated honestly.
MIT © Finikos S.r.l.
Space Context MCP soruları
Space Context MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http spacecontext https://mcp.spacecontext.app/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Space Context 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.
Space Context MCP hangi araçları sunar?
13 araç sunar; bunlar arasında list_spaces, search_spaces, get_space, get_space_markdown, ask_space yer alır.
Yapay zeka asistanı Wi-Fi şifreleri gibi hassas bilgileri görebilir mi?
Varsayılan olarak asistan, bağlantı işlemi sırasında açıkça izin vermediğiniz sürece Wi-Fi şifreleri veya kapı kodları gibi hassas değerleri göremez.