Skip to content

Pubky MCP server#5

Open
infin1t3 wants to merge 13 commits intopubky:mainfrom
infin1t3:main
Open

Pubky MCP server#5
infin1t3 wants to merge 13 commits intopubky:mainfrom
infin1t3:main

Conversation

@infin1t3
Copy link

No description provided.

…ments

Major Integration:
- Added Pkarr (Layer 1a): Discovery protocol via Mainline DHT
- Added Pkdns (Layer 1b): DNS resolver for Pkarr domains as TLDs
- Added Pubky Nexus (Layer 4b): Social indexer implementation details

Code Quality:
- Removed unused files (tools.refactored.ts, tools/base.ts, 3 internal docs)
- Removed unused imports (PKARR_DESIGN_DOCS)
- Added helper function createTextResponse() to reduce duplication
- Added type aliases (ToolResponse, PromptResponse, ResourceResponse)
- Added table of contents and section markers for navigation
- Cleaned up empty directories

New Features:
- 75+ resources across 6 projects
- 65+ development tools
- Pkarr relay management (start/stop/status)
- DNS resolver setup guides (browser/system)
- Nexus architecture and dev environment tools
- Complete DNS record publishing workflow

Documentation Updates:
- Updated README.md with 6-project coverage
- Updated SETUP.md with new resource counts
- Updated QUICKSTART.md with pkdns and Nexus examples
- Updated startup message to show all 6 projects

Technical Changes:
- Extended FileReader to support pkdns and pubky-nexus
- Added PkarrRelayManager utility for relay lifecycle
- Extended resource handlers for pkdns:// and nexus:// URIs
- Added 21 new MCP tools (14 Pkarr + 4 Pkdns + 3 Nexus)
- Added 5 new code templates for Pkarr
- Updated fetch-resources.sh to clone pkdns and pubky-nexus

Verified:
✅ Build passes (TypeScript 0 errors, 0 warnings)
✅ Server starts correctly
✅ All resources fetch successfully
✅ All 6 projects integrated and functional
Cleanup:
- Removed ARCHITECTURE_UPDATE.md (no longer needed)
- Updated cursor-config-example.json (removed env vars, simplified)
- Updated package.json description and keywords for all 6 projects

Code Quality:
- Fixed all linter warnings (7 issues)
- Removed unused error parameters
- Removed unused imports (APP_SPEC_MODELS, PKARR_CONCEPTS)
- Removed unused variables (2 readme vars)
- Applied createTextResponse() helper in more places

Verification:
✅ Build: 0 errors, 0 warnings
✅ Lint: 0 warnings, 0 errors
✅ Server: Starts correctly with all 6 projects
Pkdns uses 'master' branch instead of 'main'.
Updated fetch script to pull from correct branch.
@infin1t3 infin1t3 self-assigned this Oct 23, 2025
@infin1t3 infin1t3 requested a review from SHAcollision October 23, 2025 10:49
- Add Express HTTP server (src/server.ts) exposing MCP functionality via REST API
- Add Express and CORS dependencies to package.json
- Add start:http script for Render deployment
- Add render.yaml configuration file
- Add comprehensive deployment guide (RENDER_DEPLOYMENT.md)
- Server exposes resources, tools, and prompts via REST endpoints
- Maintains backward compatibility with stdio-based MCP server
- Add postinstall script that runs build:quick after npm install
- Ensures dist/ directory is created when installing from GitHub
- Makes GitHub URL npx usage work without pre-built dist files
- Change postinstall from build:quick to full build
- Ensures resources are fetched automatically on install
- Makes GitHub URL usage fully self-contained
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant