@opsee/mcp-server 0.1.0

package/gen/validate/validate_pb.js

@@ -0,0 +1,223 @@
+// @generated by protoc-gen-es v2.2.3
+// @generated from file validate/validate.proto (package validate, syntax proto2)
+/* eslint-disable */
+
+import { enumDesc, extDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv1";
+import { file_google_protobuf_descriptor, file_google_protobuf_duration, file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+
+/**
+ * Describes the file validate/validate.proto.
+ */
+export const file_validate_validate = /*@__PURE__*/
+  fileDesc("Chd2YWxpZGF0ZS92YWxpZGF0ZS5wcm90bxIIdmFsaWRhdGUimAcKCkZpZWxkUnVsZXMSJwoHbWVzc2FnZRgRIAEoCzIWLnZhbGlkYXRlLk1lc3NhZ2VSdWxlcxIlCgVmbG9hdBgBIAEoCzIULnZhbGlkYXRlLkZsb2F0UnVsZXNIABInCgZkb3VibGUYAiABKAsyFS52YWxpZGF0ZS5Eb3VibGVSdWxlc0gAEiUKBWludDMyGAMgASgLMhQudmFsaWRhdGUuSW50MzJSdWxlc0gAEiUKBWludDY0GAQgASgLMhQudmFsaWRhdGUuSW50NjRSdWxlc0gAEicKBnVpbnQzMhgFIAEoCzIVLnZhbGlkYXRlLlVJbnQzMlJ1bGVzSAASJwoGdWludDY0GAYgASgLMhUudmFsaWRhdGUuVUludDY0UnVsZXNIABInCgZzaW50MzIYByABKAsyFS52YWxpZGF0ZS5TSW50MzJSdWxlc0gAEicKBnNpbnQ2NBgIIAEoCzIVLnZhbGlkYXRlLlNJbnQ2NFJ1bGVzSAASKQoHZml4ZWQzMhgJIAEoCzIWLnZhbGlkYXRlLkZpeGVkMzJSdWxlc0gAEikKB2ZpeGVkNjQYCiABKAsyFi52YWxpZGF0ZS5GaXhlZDY0UnVsZXNIABIrCghzZml4ZWQzMhgLIAEoCzIXLnZhbGlkYXRlLlNGaXhlZDMyUnVsZXNIABIrCghzZml4ZWQ2NBgMIAEoCzIXLnZhbGlkYXRlLlNGaXhlZDY0UnVsZXNIABIjCgRib29sGA0gASgLMhMudmFsaWRhdGUuQm9vbFJ1bGVzSAASJwoGc3RyaW5nGA4gASgLMhUudmFsaWRhdGUuU3RyaW5nUnVsZXNIABIlCgVieXRlcxgPIAEoCzIULnZhbGlkYXRlLkJ5dGVzUnVsZXNIABIjCgRlbnVtGBAgASgLMhMudmFsaWRhdGUuRW51bVJ1bGVzSAASKwoIcmVwZWF0ZWQYEiABKAsyFy52YWxpZGF0ZS5SZXBlYXRlZFJ1bGVzSAASIQoDbWFwGBMgASgLMhIudmFsaWRhdGUuTWFwUnVsZXNIABIhCgNhbnkYFCABKAsyEi52YWxpZGF0ZS5BbnlSdWxlc0gAEisKCGR1cmF0aW9uGBUgASgLMhcudmFsaWRhdGUuRHVyYXRpb25SdWxl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bl9wYWlycxgBIAEoBBIRCgltYXhfcGFpcnMYAiABKAQSEQoJbm9fc3BhcnNlGAMgASgIEiIKBGtleXMYBCABKAsyFC52YWxpZGF0ZS5GaWVsZFJ1bGVzEiQKBnZhbHVlcxgFIAEoCzIULnZhbGlkYXRlLkZpZWxkUnVsZXMSFAoMaWdub3JlX2VtcHR5GAYgASgIIjgKCEFueVJ1bGVzEhAKCHJlcXVpcmVkGAEgASgIEgoKAmluGAIgAygJEg4KBm5vdF9pbhgDIAMoCSK7AgoNRHVyYXRpb25SdWxlcxIQCghyZXF1aXJlZBgBIAEoCBIoCgVjb25zdBgCIAEoCzIZLmdvb2dsZS5wcm90b2J1Zi5EdXJhdGlvbhIlCgJsdBgDIAEoCzIZLmdvb2dsZS5wcm90b2J1Zi5EdXJhdGlvbhImCgNsdGUYBCABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb24SJQoCZ3QYBSABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb24SJgoDZ3RlGAYgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uEiUKAmluGAcgAygLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uEikKBm5vdF9pbhgIIAMoCzIZLmdvb2dsZS5wcm90b2J1Zi5EdXJhdGlvbiK6AgoOVGltZXN0YW1wUnVsZXMSEAoIcmVxdWlyZWQYASABKAgSKQoFY29uc3QYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiYKAmx0GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBInCgNsdGUYBCABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiYKAmd0GAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBInCgNndGUYBiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEg4KBmx0X25vdxgHIAEoCBIOCgZndF9ub3cYCCABKAgSKQoGd2l0aGluGAkgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uKkYKCktub3duUmVnZXgSCwoHVU5LTk9XThAAEhQKEEhUVFBfSEVBREVSX05BTUUQARIVChFIVFRQX0hFQURFUl9WQUxVRRACOjwKCGRpc2FibGVkEh8uZ29vZ2xlLnByb3RvYnVmLk1lc3NhZ2VPcHRpb25zGK8IIAEoCFIIZGlzYWJsZWQ6OgoHaWdub3JlZBIfLmdvb2dsZS5wcm90b2J1Zi5NZXNzYWdlT3B0aW9ucxiwCCABKAhSB2lnbm9yZWQ6OgoIcmVxdWlyZWQSHS5nb29nbGUucHJvdG9idWYuT25lb2ZPcHRpb25zGK8IIAEoCFIIcmVxdWlyZWQ6SgoFcnVsZXMSHS5nb29nbGUucHJvdG9idWYuRmllbGRPcHRpb25zGK8IIAEoCzIULnZhbGlkYXRlLkZpZWxkUnVsZXNSBXJ1bGVzQpEBCgxjb20udmFsaWRhdGVCDVZhbGlkYXRlUHJvdG9QAVoyZ2l0aHViLmNvbS9lbnZveXByb3h5L3Byb3RvYy1nZW4tdmFsaWRhdGUvdmFsaWRhdGWiAgNWWFiqAghWYWxpZGF0ZcoCCFZhbGlkYXRl4gIUVmFsaWRhdGVcR1BCTWV0YWRhdGHqAghWYWxpZGF0ZQ", [file_google_protobuf_descriptor, file_google_protobuf_duration, file_google_protobuf_timestamp]);
+
+/**
+ * Describes the message validate.FieldRules.
+ * Use `create(FieldRulesSchema)` to create a new message.
+ */
+export const FieldRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 0);
+
+/**
+ * Describes the message validate.FloatRules.
+ * Use `create(FloatRulesSchema)` to create a new message.
+ */
+export const FloatRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 1);
+
+/**
+ * Describes the message validate.DoubleRules.
+ * Use `create(DoubleRulesSchema)` to create a new message.
+ */
+export const DoubleRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 2);
+
+/**
+ * Describes the message validate.Int32Rules.
+ * Use `create(Int32RulesSchema)` to create a new message.
+ */
+export const Int32RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 3);
+
+/**
+ * Describes the message validate.Int64Rules.
+ * Use `create(Int64RulesSchema)` to create a new message.
+ */
+export const Int64RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 4);
+
+/**
+ * Describes the message validate.UInt32Rules.
+ * Use `create(UInt32RulesSchema)` to create a new message.
+ */
+export const UInt32RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 5);
+
+/**
+ * Describes the message validate.UInt64Rules.
+ * Use `create(UInt64RulesSchema)` to create a new message.
+ */
+export const UInt64RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 6);
+
+/**
+ * Describes the message validate.SInt32Rules.
+ * Use `create(SInt32RulesSchema)` to create a new message.
+ */
+export const SInt32RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 7);
+
+/**
+ * Describes the message validate.SInt64Rules.
+ * Use `create(SInt64RulesSchema)` to create a new message.
+ */
+export const SInt64RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 8);
+
+/**
+ * Describes the message validate.Fixed32Rules.
+ * Use `create(Fixed32RulesSchema)` to create a new message.
+ */
+export const Fixed32RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 9);
+
+/**
+ * Describes the message validate.Fixed64Rules.
+ * Use `create(Fixed64RulesSchema)` to create a new message.
+ */
+export const Fixed64RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 10);
+
+/**
+ * Describes the message validate.SFixed32Rules.
+ * Use `create(SFixed32RulesSchema)` to create a new message.
+ */
+export const SFixed32RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 11);
+
+/**
+ * Describes the message validate.SFixed64Rules.
+ * Use `create(SFixed64RulesSchema)` to create a new message.
+ */
+export const SFixed64RulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 12);
+
+/**
+ * Describes the message validate.BoolRules.
+ * Use `create(BoolRulesSchema)` to create a new message.
+ */
+export const BoolRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 13);
+
+/**
+ * Describes the message validate.StringRules.
+ * Use `create(StringRulesSchema)` to create a new message.
+ */
+export const StringRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 14);
+
+/**
+ * Describes the message validate.BytesRules.
+ * Use `create(BytesRulesSchema)` to create a new message.
+ */
+export const BytesRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 15);
+
+/**
+ * Describes the message validate.EnumRules.
+ * Use `create(EnumRulesSchema)` to create a new message.
+ */
+export const EnumRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 16);
+
+/**
+ * Describes the message validate.MessageRules.
+ * Use `create(MessageRulesSchema)` to create a new message.
+ */
+export const MessageRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 17);
+
+/**
+ * Describes the message validate.RepeatedRules.
+ * Use `create(RepeatedRulesSchema)` to create a new message.
+ */
+export const RepeatedRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 18);
+
+/**
+ * Describes the message validate.MapRules.
+ * Use `create(MapRulesSchema)` to create a new message.
+ */
+export const MapRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 19);
+
+/**
+ * Describes the message validate.AnyRules.
+ * Use `create(AnyRulesSchema)` to create a new message.
+ */
+export const AnyRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 20);
+
+/**
+ * Describes the message validate.DurationRules.
+ * Use `create(DurationRulesSchema)` to create a new message.
+ */
+export const DurationRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 21);
+
+/**
+ * Describes the message validate.TimestampRules.
+ * Use `create(TimestampRulesSchema)` to create a new message.
+ */
+export const TimestampRulesSchema = /*@__PURE__*/
+  messageDesc(file_validate_validate, 22);
+
+/**
+ * Describes the enum validate.KnownRegex.
+ */
+export const KnownRegexSchema = /*@__PURE__*/
+  enumDesc(file_validate_validate, 0);
+
+/**
+ * WellKnownRegex contain some well-known patterns.
+ *
+ * @generated from enum validate.KnownRegex
+ */
+export const KnownRegex = /*@__PURE__*/
+  tsEnum(KnownRegexSchema);
+
+/**
+ * Disabled nullifies any validation rules for this message, including any
+ * message fields associated with it that do support validation.
+ *
+ * @generated from extension: optional bool disabled = 1071;
+ */
+export const disabled = /*@__PURE__*/
+  extDesc(file_validate_validate, 0);
+
+/**
+ * Ignore skips generation of validation methods for this message.
+ *
+ * @generated from extension: optional bool ignored = 1072;
+ */
+export const ignored = /*@__PURE__*/
+  extDesc(file_validate_validate, 1);
+
+/**
+ * Required ensures that exactly one the field options in a oneof is set;
+ * validation fails if no fields in the oneof are set.
+ *
+ * @generated from extension: optional bool required = 1071;
+ */
+export const required = /*@__PURE__*/
+  extDesc(file_validate_validate, 2);
+
+/**
+ * Rules specify the validations to be performed on this field. By default,
+ * no validation is performed against a field.
+ *
+ * @generated from extension: optional validate.FieldRules rules = 1071;
+ */
+export const rules = /*@__PURE__*/
+  extDesc(file_validate_validate, 3);
+

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@opsee/mcp-server",
+  "version": "0.1.0",
+  "description": "Opsee MCP server — manage projects, tasks, docs, and cycles from AI coding environments",
+  "type": "module",
+  "bin": {
+    "opsee-mcp": "./bin/opsee-mcp.js"
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "start": "npx tsx src/index.ts",
+    "proto-local": "rm -rf ./gen && cd .. && buf build -o mcp/descriptor.bin && cd mcp && buf generate --include-imports descriptor.bin && rm descriptor.bin",
+    "proto": "rm -rf ./gen && curl -k 'https://general.storage.codilas.link/opsee/proto/descriptor.bin' --output ./descriptor.bin && buf generate --include-imports descriptor.bin && rm ./descriptor.bin",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.2.3",
+    "@connectrpc/connect": "^2.0.2",
+    "@connectrpc/connect-node": "^2.0.2",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "open": "^10.1.0",
+    "tsx": "^4.21.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "src",
+    "bin",
+    "gen"
+  ]
+}

package/src/auth/credentials.ts

@@ -0,0 +1,65 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+
+export interface Credentials {
+  token: string;
+  serverUrl: string;
+  userId: string;
+  companyId: string;
+  expiresAt: string;
+}
+
+function getCredentialsPath(): string {
+  if (process.env.OPSEE_CREDENTIALS_PATH) {
+    return process.env.OPSEE_CREDENTIALS_PATH;
+  }
+  return join(homedir(), ".opsee", "credentials.json");
+}
+
+export function readCredentials(): Credentials | null {
+  // Environment variable token takes precedence (for CI/headless)
+  if (process.env.OPSEE_API_TOKEN) {
+    return {
+      token: process.env.OPSEE_API_TOKEN,
+      serverUrl: process.env.OPSEE_API_URL || "https://api.opsee.dev",
+      userId: "",
+      companyId: "",
+      expiresAt: "",
+    };
+  }
+
+  const path = getCredentialsPath();
+  if (!existsSync(path)) {
+    return null;
+  }
+
+  try {
+    const data = JSON.parse(readFileSync(path, "utf-8"));
+    if (!data.token) return null;
+    return data as Credentials;
+  } catch {
+    return null;
+  }
+}
+
+export function writeCredentials(credentials: Credentials): void {
+  const path = getCredentialsPath();
+  const dir = dirname(path);
+
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+  }
+
+  writeFileSync(path, JSON.stringify(credentials, null, 2), {
+    mode: 0o600,
+    encoding: "utf-8",
+  });
+}
+
+export function clearCredentials(): void {
+  const path = getCredentialsPath();
+  if (existsSync(path)) {
+    writeFileSync(path, "{}", { mode: 0o600, encoding: "utf-8" });
+  }
+}

package/src/auth/login.ts

@@ -0,0 +1,96 @@
+import { createServer as createHttpServer, type IncomingMessage, type ServerResponse } from "node:http";
+import { writeCredentials, type Credentials } from "./credentials.js";
+
+const SUCCESS_HTML = `<!DOCTYPE html>
+<html>
+<head><title>Opsee MCP - Connected</title></head>
+<body style="font-family: system-ui; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #f8f9fa;">
+  <div style="text-align: center; padding: 2rem;">
+    <h1 style="color: #10b981;">Connected!</h1>
+    <p>Your Opsee account is now linked to the MCP server.</p>
+    <p style="color: #6b7280;">You can close this window.</p>
+  </div>
+</body>
+</html>`;
+
+const ERROR_HTML = `<!DOCTYPE html>
+<html>
+<head><title>Opsee MCP - Error</title></head>
+<body style="font-family: system-ui; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #f8f9fa;">
+  <div style="text-align: center; padding: 2rem;">
+    <h1 style="color: #ef4444;">Authentication Failed</h1>
+    <p>Could not connect your Opsee account. Please try again.</p>
+  </div>
+</body>
+</html>`;
+
+export async function startLoginFlow(): Promise<void> {
+  const port = 9876;
+  const callbackUrl = `http://localhost:${port}/callback`;
+  const appUrl = process.env.OPSEE_APP_URL || "https://app.opsee.dev";
+  const loginUrl = `${appUrl}/auth/mcp?callback=${encodeURIComponent(callbackUrl)}`;
+
+  return new Promise<void>((resolve, reject) => {
+    const server = createHttpServer((req: IncomingMessage, res: ServerResponse) => {
+      const url = new URL(req.url || "/", `http://localhost:${port}`);
+
+      if (url.pathname === "/callback") {
+        const token = url.searchParams.get("token");
+        const userId = url.searchParams.get("userId") || "";
+        const companyId = url.searchParams.get("companyId") || "";
+        const expiresAt = url.searchParams.get("expiresAt") || "";
+
+        if (token) {
+          const credentials: Credentials = {
+            token,
+            serverUrl: process.env.OPSEE_API_URL || "https://api.opsee.dev",
+            userId,
+            companyId,
+            expiresAt,
+          };
+
+          writeCredentials(credentials);
+
+          res.writeHead(200, { "Content-Type": "text/html" });
+          res.end(SUCCESS_HTML);
+
+          console.log("Successfully authenticated with Opsee!");
+          server.close();
+          resolve();
+        } else {
+          res.writeHead(400, { "Content-Type": "text/html" });
+          res.end(ERROR_HTML);
+
+          server.close();
+          reject(new Error("No token received in callback"));
+        }
+      } else {
+        res.writeHead(404);
+        res.end("Not found");
+      }
+    });
+
+    server.listen(port, () => {
+      console.log(`Opening browser for Opsee authentication...`);
+      console.log(`If your browser doesn't open, visit: ${loginUrl}`);
+
+      // Dynamic import for ESM-only package
+      import("open").then((mod) => mod.default(loginUrl)).catch(() => {
+        console.log(`Please open the following URL in your browser:\n${loginUrl}`);
+      });
+    });
+
+    server.on("error", (err) => {
+      if ((err as NodeJS.ErrnoException).code === "EADDRINUSE") {
+        console.error(`Port ${port} is already in use. Please close other instances and try again.`);
+      }
+      reject(err);
+    });
+
+    // Timeout after 5 minutes
+    setTimeout(() => {
+      server.close();
+      reject(new Error("Login timed out after 5 minutes"));
+    }, 5 * 60 * 1000);
+  });
+}

package/src/auth/manager.ts

@@ -0,0 +1,49 @@
+import { readCredentials, clearCredentials, type Credentials } from "./credentials.js";
+
+export class AuthManager {
+  private credentials: Credentials | null = null;
+
+  getToken(): string | null {
+    this.credentials = readCredentials();
+    if (!this.credentials) return null;
+
+    if (this.isExpired()) {
+      return null;
+    }
+
+    return this.credentials.token;
+  }
+
+  getServerUrl(): string {
+    return (
+      process.env.OPSEE_API_URL ||
+      this.credentials?.serverUrl ||
+      "https://api.opsee.dev"
+    );
+  }
+
+  getUserId(): string {
+    return this.credentials?.userId || "";
+  }
+
+  getCompanyId(): string {
+    return this.credentials?.companyId || "";
+  }
+
+  isAuthenticated(): boolean {
+    return this.getToken() !== null;
+  }
+
+  private isExpired(): boolean {
+    if (!this.credentials?.expiresAt) return false;
+    const expiry = new Date(this.credentials.expiresAt);
+    return expiry.getTime() < Date.now();
+  }
+
+  handleAuthError(): string {
+    clearCredentials();
+    return "Not authenticated. Run `npx opsee-mcp login` to connect your Opsee account.";
+  }
+}
+
+export const authManager = new AuthManager();

package/src/client/api.ts

@@ -0,0 +1,91 @@
+import { createClient, type Interceptor, type Client } from "@connectrpc/connect";
+import { createConnectTransport } from "@connectrpc/connect-node";
+import { create } from "@bufbuild/protobuf";
+import type { GenService } from "@bufbuild/protobuf/codegenv1";
+import { authManager } from "../auth/manager.js";
+import {
+  PaginationSchema,
+  type Pagination,
+} from "../../gen/api/v1/pagination_pb.js";
+import { OrderByEnum } from "../../gen/api/v1/pagination_pb.js";
+import { ProjectService } from "../../gen/api/v1/project_pb.js";
+import { TaskService } from "../../gen/api/v1/task_pb.js";
+import { BoardService } from "../../gen/api/v1/board_pb.js";
+import { BoardColumnService } from "../../gen/api/v1/board_column_pb.js";
+import { CycleService } from "../../gen/api/v1/cycle_pb.js";
+import { DocSpaceService } from "../../gen/api/v1/doc_space_pb.js";
+import { DocPageService } from "../../gen/api/v1/doc_page_pb.js";
+import { TaskTypeService } from "../../gen/api/v1/task_type_pb.js";
+import { TaskPriorityService } from "../../gen/api/v1/task_priority_pb.js";
+import { UserService } from "../../gen/api/v1/user_pb.js";
+import { VCSIntegrationService } from "../../gen/api/v1/vcs_integration_pb.js";
+
+const authInterceptor: Interceptor = (next) => async (req) => {
+  const token = authManager.getToken();
+  if (token) {
+    req.header.set("Authorization", `Bearer ${token}`);
+  }
+  return await next(req);
+};
+
+const paginationInterceptor: Interceptor = (next) => async (req) => {
+  const fields = req.method.input.fields;
+  const hasPagination = fields.find((f) => f.name === "pagination");
+  if (
+    hasPagination &&
+    !(req.message as Record<string, unknown>)["pagination"]
+  ) {
+    (req.message as Record<string, unknown>)["pagination"] =
+      overridePagination();
+  }
+  return await next(req);
+};
+
+export function overridePagination(): Pagination {
+  return create(PaginationSchema, {
+    orderBy: OrderByEnum.ASC,
+    overridePagination: true,
+  });
+}
+
+export function defaultPagination(
+  page: number = 1,
+  pageSize: number = 50
+): Pagination {
+  return create(PaginationSchema, {
+    page,
+    pageSize,
+    orderBy: OrderByEnum.ASC,
+  });
+}
+
+function createTransport() {
+  return createConnectTransport({
+    baseUrl: authManager.getServerUrl(),
+    httpVersion: "1.1",
+    interceptors: [authInterceptor, paginationInterceptor],
+  });
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function makeClient<T extends GenService<any>>(service: T): Client<T> {
+  return createClient(service, createTransport());
+}
+
+export function getClients() {
+  return {
+    projects: makeClient(ProjectService),
+    tasks: makeClient(TaskService),
+    boards: makeClient(BoardService),
+    boardColumns: makeClient(BoardColumnService),
+    cycles: makeClient(CycleService),
+    docSpaces: makeClient(DocSpaceService),
+    docPages: makeClient(DocPageService),
+    taskTypes: makeClient(TaskTypeService),
+    taskPriorities: makeClient(TaskPriorityService),
+    users: makeClient(UserService),
+    vcsIntegrations: makeClient(VCSIntegrationService),
+  };
+}
+
+export type ApiClients = ReturnType<typeof getClients>;

package/src/index.ts

@@ -0,0 +1,13 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+
+async function main() {
+  const server = createServer();
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/src/server.ts

@@ -0,0 +1,26 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getClients } from "./client/api.js";
+import { registerUserTools } from "./tools/user.js";
+import { registerProjectTools } from "./tools/projects.js";
+import { registerTaskTools } from "./tools/tasks.js";
+import { registerTaskMetadataTools } from "./tools/task-metadata.js";
+import { registerCycleTools } from "./tools/cycles.js";
+import { registerDocTools } from "./tools/docs.js";
+import { registerRepositoryTools } from "./tools/repositories.js";
+
+export function createServer(): McpServer {
+  const server = new McpServer({
+    name: "opsee",
+    version: "0.1.0",
+  });
+
+  registerUserTools(server, getClients);
+  registerProjectTools(server, getClients);
+  registerTaskTools(server, getClients);
+  registerTaskMetadataTools(server, getClients);
+  registerCycleTools(server, getClients);
+  registerDocTools(server, getClients);
+  registerRepositoryTools(server, getClients);
+
+  return server;
+}