Feat/export csv extent types

.dockerignore

@@ -31,4 +31,7 @@
 # Workspace package dependencies.
 !packages/hypergraph
 !packages/hypergraph-react
-!packages/typesync-studio
+!packages/typesync-studio
+
+# MCP server.
+!packages/mcp-server

.gitignore

@@ -71,4 +71,7 @@ next-env.d.ts
 .DS_Store
 
 # tanstack router output
-.tanstack
+.tanstack
+
+.claude
+.planning

Dockerfile.mcp

@@ -0,0 +1,32 @@
+# syntax=docker/dockerfile:1.4
+
+# Installation stage.
+FROM node:22-alpine AS base
+WORKDIR /workspace
+# Install pnpm via corepack.
+ADD package.json .
+RUN npm install --global corepack@latest
+RUN corepack enable && corepack prepare --activate
+ENV CI=true
+# Fetch all node modules purely based on the pnpm lock file.
+COPY pnpm-lock.yaml .
+RUN pnpm fetch
+# Copy the entire workspace into the scope and perform the actual installation.
+COPY . .
+RUN pnpm install
+
+# Build stage.
+FROM base AS build
+RUN \
+  pnpm --filter @graphprotocol/mcp-server build && \
+  pnpm --filter @graphprotocol/mcp-server deploy --prod deployment --legacy && \
+  mkdir -p deployment/out && \
+  mv deployment/dist deployment/node_modules deployment/package.json deployment/out && \
+  cp -r packages/mcp-server/config deployment/out/config
+
+# Slim runtime image.
+FROM node:22-alpine AS runtime
+WORKDIR /app
+COPY --from=build /workspace/deployment/out .
+EXPOSE 3000
+CMD ["node", "dist/http.js"]

packages/mcp-server/config/spaces.json

@@ -0,0 +1,55 @@
+{
+  "endpoint": "https://testnet-api.geobrowser.io",
+  "spaces": [
+    {
+      "name": "Geo",
+      "id": "a19c345ab9866679b001d7d2138d88a1",
+      "description": "Geo space"
+    },
+    {
+      "name": "AI",
+      "id": "41e851610e13a19441c4d980f2f2ce6b",
+      "description": "AI space"
+    },
+    {
+      "name": "Crypto",
+      "id": "c9f267dcb0d270718c2a3c45a64afd32",
+      "description": "Crypto space"
+    },
+    {
+      "name": "Health",
+      "id": "52c7ae149838b6d47ce0f3b2a5974546",
+      "description": "Health space"
+    },
+    {
+      "name": "Industries",
+      "id": "d69608290513c2a91102c939b3265bd7",
+      "description": "Industries space"
+    },
+    {
+      "name": "Technology",
+      "id": "870e3b3068661e6280fad2ab456829bc",
+      "description": "Technology space"
+    },
+    {
+      "name": "Software",
+      "id": "9b611b848b12491b9b6b43f3cf019b8b",
+      "description": "Software space"
+    },
+    {
+      "name": "Geo Education",
+      "id": "720eb279c64d56735dccd17a2a416ba2",
+      "description": "Geo Education space"
+    },
+    {
+      "name": "Healthcare",
+      "id": "5d3e53b46f2dd38caa231ccc763212f5",
+      "description": "Healthcare space"
+    },
+    {
+      "name": "Podcast App",
+      "id": "b5a31f8182b042437ede0f84ee02f104",
+      "description": "Podcast App space"
+    }
+  ]
+}

packages/mcp-server/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@graphprotocol/mcp-server",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "dev:http": "tsx src/http.ts",
+    "start": "node dist/http.js",
+    "build": "tsc -b tsconfig.build.json",
+    "test": "vitest",
+    "lint": "biome check",
+    "lint:fix": "biome check --write --unsafe",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "express": "^5.1.0",
+    "zod": "^3.25.0",
+    "graphql-request": "^7.2.0",
+    "graphql": "^16.10.0",
+    "effect": "^3.17.13",
+    "@geoprotocol/geo-sdk": "^0.9.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "typescript": "^5.9.2",
+    "tsx": "^4.20.5",
+    "@types/node": "^24.1.0",
+    "vitest": "^3.2.4",
+    "@effect/vitest": "^0.25.1"
+  }
+}

packages/mcp-server/src/config.ts

@@ -0,0 +1,34 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Effect } from 'effect';
+import { z } from 'zod';
+import { ConfigError } from './errors.js';
+
+export const SpaceConfigSchema = z.object({
+  name: z.string(),
+  id: z.string(),
+  description: z.string(),
+});
+
+export const ConfigSchema = z.object({
+  endpoint: z.string().url(),
+  spaces: z.array(SpaceConfigSchema).min(1),
+});
+
+export type SpacesConfig = z.infer<typeof ConfigSchema>;
+export type SpaceConfig = z.infer<typeof SpaceConfigSchema>;
+
+export const loadConfig = (
+  configPath: string = resolve(import.meta.dirname, '..', 'config', 'spaces.json'),
+): Effect.Effect<SpacesConfig, ConfigError> =>
+  Effect.try({
+    try: () => {
+      const raw = readFileSync(configPath, 'utf-8');
+      const json: unknown = JSON.parse(raw);
+      return ConfigSchema.parse(json);
+    },
+    catch: () =>
+      new ConfigError({
+        message: 'Failed to load configuration. Ensure config file exists and is valid JSON.',
+      }),
+  });

packages/mcp-server/src/errors.ts

@@ -0,0 +1,15 @@
+import { Data } from 'effect';
+
+export class ConfigError extends Data.TaggedError('ConfigError')<{
+  readonly message: string;
+}> {}
+
+export class PrefetchError extends Data.TaggedError('PrefetchError')<{
+  readonly space: string;
+  readonly cause: unknown;
+}> {}
+
+export class GraphQLError extends Data.TaggedError('GraphQLError')<{
+  readonly query: string;
+  readonly cause: unknown;
+}> {}