MCP Integration

// From src/shared/mcp.ts:11
export type McpServer = {
  name: string                    // Unique identifier
  config: string                  // JSON configuration
  status: "connected" | "connecting" | "disconnected"
  error?: string                  // Error message if failed
  tools?: McpTool[]              // Available tools
  resources?: McpResource[]      // Available resources
  resourceTemplates?: McpResourceTemplate[]
  prompts?: McpPrompt[]          // Available prompts
  disabled?: boolean             // Enable/disable toggle
  timeout?: number               // Execution timeout (seconds)
  uid?: string                   // Unique instance ID
  oauthRequired?: boolean        // Requires OAuth
  oauthAuthStatus?: McpOAuthAuthStatus
}

// From src/shared/mcp.ts:7
export const DEFAULT_MCP_TIMEOUT_SECONDS = 60
export const MIN_MCP_TIMEOUT_SECONDS = 1

// From src/core/prompts/system-prompt/components/mcp.ts:53
function formatMcpServersList(servers: McpServer[]): string {
  return servers
    .filter((server) => server.status === "connected")
    .map((server) => {
      const tools = server.tools
        ?.map((tool) => {
          const schemaStr = tool.inputSchema
            ? `Input Schema: ${JSON.stringify(tool.inputSchema, null, 2)}`
            : ""
          return `- ${tool.name}: ${tool.description}\n${schemaStr}`
        })
        .join("\n\n")
      
      return `## ${server.name}\n### Available Tools\n${tools}`
    })
    .join("\n\n")
}

// AI's tool call
use_mcp_tool({
  server_name: "github",
  tool_name: "create_issue",
  arguments: {
    owner: "myorg",
    repo: "myrepo",
    title: "Bug: Login button not working",
    body: "Steps to reproduce:\n1. Navigate to login page\n2. Click login button\n3. Nothing happens",
    labels: ["bug", "ui"]
  }
})

// From src/shared/mcp.ts:108
export type McpToolCallResponse = {
  _meta?: Record<string, any>
  content: Array<
    | { type: "text"; text: string }
    | { type: "image"; data: string; mimeType: string }
    | { type: "resource"; resource: { uri: string; text?: string } }
  >
  isError?: boolean
}

// Example response
{
  "content": [
    {
      "type": "text",
      "text": "Created issue #123: https://github.com/myorg/myrepo/issues/123"
    }
  ]
}

access_mcp_resource({
  server_name: "postgres",
  uri: "postgres://schema/public"
})

// Returns
{
  "contents": [
    {
      "uri": "postgres://schema/public",
      "mimeType": "application/json",
      "text": "{\"tables\":[{\"name\":\"users\",\"columns\":[...]}]}"
    }
  ]
}

// From src/shared/mcp.ts:56
export type McpPrompt = {
  name: string
  title?: string
  description?: string
  arguments?: McpPromptArgument[]
}

export type McpPromptArgument = {
  name: string
  description?: string
  required?: boolean
}

{
  "name": "code_review",
  "title": "Code Review Assistant",
  "description": "Review code for best practices and potential issues",
  "arguments": [
    {
      "name": "language",
      "description": "Programming language",
      "required": true
    },
    {
      "name": "focus_areas",
      "description": "Specific areas to focus on (security, performance, etc.)",
      "required": false
    }
  ]
}

// From src/shared/mcp.ts:23
oauthRequired?: boolean
oauthAuthStatus?: McpOAuthAuthStatus  // "authenticated" | "unauthenticated" | "pending"

// From src/shared/mcp.ts:145
export interface McpMarketplaceItem {
  mcpId: string                    // Unique marketplace ID
  githubUrl: string                // Source repository
  name: string
  author: string
  description: string
  codiconIcon: string              // Icon identifier
  logoUrl: string
  category: string                 // Web, Database, DevTools, etc.
  tags: string[]                   // Searchable tags
  requiresApiKey: boolean
  readmeContent?: string
  llmsInstallationContent?: string
  isRecommended: boolean
  githubStars: number
  downloadCount: number
  createdAt: string
  updatedAt: string
  lastGithubSync: string
  isLocal?: boolean                // Installed locally
}