adhit-r / adhit-r/aran-mcp

Implement Automated MCP Server Discovery

未关闭
#33 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
backend enhancement feature frontend infrastructure networking
主要语言
TypeScript
星标
0
派生
2
PR 合并指标
30 天内没有已合并 PR

描述

## Overview
Implement automated discovery of MCP servers on the network with endpoint scanning and auto-registration.

## Business Value
Automated discovery reduces manual configuration effort and helps identify all MCP servers in an environment.

## Technology Stack
- Backend: Go, network programming
- Frontend: TypeScript, React, Next.js
- Protocols: MCP protocol, HTTP/HTTPS
- Scheduling: Cron-based job system

## Skill Level Required
- Intermediate to Advanced
- Understanding of network programming
- Knowledge of port scanning and network protocols
- Experience with background job processing

## Learning Opportunities
- Learn network scanning and discovery techniques
- Understand MCP protocol implementation
- Practice building scheduled job systems
- Gain experience with network security considerations
- Learn about building discovery dashboards

## Impact
This feature automates a critical operational task and demonstrates advanced networking and protocol knowledge. Contributors will work on a challenging problem that combines networking, protocol implementation, and UI development.

## Current State
- Basic discovery infrastructure exists in backend/internal/discovery/
- Endpoint scanner exists but needs completion
- No automated scanning scheduled

## Subtasks
- [ ] Complete endpoint scanner implementation
- [ ] Add network range scanning
- [ ] Implement port scanning for MCP servers
- [ ] Add auto-registration of discovered servers
- [ ] Create discovery scheduling system
- [ ] Add discovery results UI
- [ ] Implement discovery filters and exclusions

## Implementation Steps
1. Complete backend/internal/discovery/endpoint_scanner.go
2. Add network scanning capabilities
3. Implement MCP protocol detection
4. Add scheduled discovery jobs
5. Create discovery dashboard in frontend

## Getting Started
1. Review backend/internal/discovery/ directory structure
2. Study MCP protocol specification
3. Review existing server registration code
4. Check frontend dashboard components for UI patterns

## Acceptance Criteria
- [ ] Can scan specified network ranges
- [ ] Detects MCP servers on common ports
- [ ] Auto-registers discovered servers
- [ ] Discovery can be scheduled
- [ ] Discovery results are displayed in UI
- [ ] False positives are minimized

## Estimated Effort
- Hours: 16-20
- Complexity: High

贡献指南

打开贡献指南

调研方向

Start by reviewing backend/internal/discovery/endpoint_scanner.go and the surrounding discovery directory, then inspect existing server registration code and frontend dashboard components. Confirm the MCP protocol detection and network-scanning requirements before implementation. Done means scheduled scans cover specified ranges, detect and register MCP servers, minimize false positives, and display filtered results in the UI.

由索引模型根据 Issue 内容生成。

评估

技术栈
go, next.js, react, typescript
领域
backend, frontend, networking
Issue 类型
功能
难度
5/5
预计耗时
一周以上
活跃度
停滞
描述清晰度
基本清楚
新手友好度
25/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。