History

Svrnty d936ad7856 docs: comprehensive AI coding assistant research and MCP-first implementation plan Research conducted on modern AI coding assistants (Cursor, GitHub Copilot, Cline, Aider, Windsurf, Replit Agent) to understand architecture patterns, context management, code editing workflows, and tool use protocols. Key Decision: Pivoted from building full CLI (40-50h) to validation-driven MCP-first approach (10-15h). Build 5 core CODEX MCP tools that work with ANY coding assistant, validate adoption over 2-4 weeks, then decide on full CLI if demand proven. Files: - research/ai-systems/modern-coding-assistants-architecture.md (comprehensive research) - research/ai-systems/codex-coding-assistant-implementation-plan.md (original CLI plan, preserved) - research/ai-systems/codex-mcp-tools-implementation-plan.md (approved MCP-first plan) - ideas/registry.json (updated with approved MCP tools proposal) Architech Validation: APPROVED with pivot to MCP-first approach Human Decision: Approved (pragmatic validation-driven development) Next: Begin Phase 1 implementation (10-15 hours, 5 core MCP tools) 🤖 Generated with CODEX Research System Co-Authored-By: The Archivist <archivist@codex.svrnty.io> Co-Authored-By: The Architech <architech@codex.svrnty.io> Co-Authored-By: Mathias Beaulieu-Duncan <mat@svrnty.io>		2025-10-22 21:00:34 -04:00
..
CodexMcpClient.csproj	docs: comprehensive AI coding assistant research and MCP-first implementation plan	2025-10-22 21:00:34 -04:00
Program.cs	docs: comprehensive AI coding assistant research and MCP-first implementation plan	2025-10-22 21:00:34 -04:00
README.md	docs: comprehensive AI coding assistant research and MCP-first implementation plan	2025-10-22 21:00:34 -04:00

README.md

CodexMcpClient Sample

Sample console application demonstrating OpenHarbor.MCP.Client usage with CODEX MCP Server.

Purpose

Shows how to:

Connect to an MCP server (CODEX knowledge base)
Discover available tools
Call tools with arguments
Handle responses and errors

Prerequisites

.NET 8.0 SDK
Running CODEX MCP Server (from OpenHarbor.MCP.Server module)

Configuration

Edit appsettings.json to point to your CODEX MCP Server:

{
  "Mcp": {
    "Servers": [
      {
        "Name": "codex-server",
        "Transport": {
          "Type": "Stdio",
          "Command": "dotnet",
          "Args": ["run", "--project", "/path/to/CodexMcpServer/CodexMcpServer.csproj"]
        }
      }
    ]
  }
}

Usage

# List available tools from CODEX server
dotnet run -- list-tools

# Search CODEX knowledge base
dotnet run -- search "architecture patterns"

# Get a specific document
dotnet run -- get-document <document-id>

# List all documents
dotnet run -- list-documents

# Filter by tag
dotnet run -- search-by-tag "design-pattern"

Example Output

$ dotnet run -- search "clean architecture"

Searching CODEX for: clean architecture
Found 5 results:

1. Clean Architecture Guide (ID: abc-123)
   - Layers: Core, Infrastructure, API
   - Score: 0.95

2. Dependency Rules (ID: def-456)
   - Clean Architecture principles
   - Score: 0.87

...

Files

Program.cs - Main CLI entry point
Services/CodexSearchService.cs - Search functionality
Services/DocumentService.cs - Document retrieval
appsettings.json - MCP client configuration