d936ad7856
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>
83 lines
1.6 KiB
Markdown
83 lines
1.6 KiB
Markdown
# 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:
|
|
|
|
```json
|
|
{
|
|
"Mcp": {
|
|
"Servers": [
|
|
{
|
|
"Name": "codex-server",
|
|
"Transport": {
|
|
"Type": "Stdio",
|
|
"Command": "dotnet",
|
|
"Args": ["run", "--project", "/path/to/CodexMcpServer/CodexMcpServer.csproj"]
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# 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
|