humanMCP

by kapoost

Not rated
GitHub

About

Personal MCP server for humans. Publish poetry, essays, listings with Ed25519 signatures. Store skills and memories. Bootstrap session unlocks expert team. Go stdlib only, zero deps.

Details

Author
kapoost
Categories
Other, Developer Tools

Setup

Install humanMCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/kapoost/humanmcp-go

Follow the installation instructions in the repository README, then restart your MCP client.

A personal content server speaking Model Context Protocol (MCP/JSON-RPC 2.0).

Live:https://kapoost.humanmcp.netLanding page:https://humanmcp.netMarketplace:https://marketplace.humanmcp.netNetwork explorer:https://humanmcp.net/humannetwork.htmlAuthor:kapoost (Łukasz Kapuśniak) — poet, builder, sailor. Warsaw / Malta.

humanMCP lets any human publish content and services with cryptographic proof of authorship, explicit license terms, and full control over access. Writers, artists, consultants, craftspeople, galleries, freelancers — anyone who creates valuable work. AI agents connect via MCP and interact with your content natively.

Every human can run their own instance. One server, one person, their rules.

humanmcp-go is aframework. Persona prompts and skill bodies are yours — they don't ship in this repo. Two ways to supply them:
-

Owner API / mounted volume— POSTupsert_persona/upsert_skillwith theEDIT_TOKEN, or drop JSON files into${CONTENT_DIR}/personas/and${CONTENT_DIR}/skills/on the host volume.

External vault (recommended)— setVAULT_URLenv to a server you control (e.g. a private FastAPI on your tailnet). SkillStore fetchesGET ${VAULT_URL}/persona/{id}andGET ${VAULT_URL}/skill/{slug}on demand with a 5min in-memory cache. Lets your sensitive prompts stay on your machine while the public framework serves them.

{"id":"hermes","name":"Hermes","role":"Process Optimizer","prompt":"<full system prompt>"}
{"slug":"system-diagram","title":"...","description":"...","persona_id":"mira","tags":[...],"instructions":"<full playbook>"}

WhenVAULT_URLis unreachable, bootstrap_session loudly reports the downgrade (won't silently fall back). Seeinternal/content/skill.gofor the fetch/cache implementation.

{ "mcpServers": { "kapoost": { "type": "http", "url": "https://kapoost.humanmcp.net/mcp" } } }

- Types:poem,essay,note,artwork,image,contact
- Access:public/members/locked
- Gates:challenge(Q&A),time,manual,trade
- Licenses:free,cc-by,cc-by-nc,commercial,exclusive,all-rights
- Price: free-form string (e.g. "500 PLN", "$200", "trade")

- Types:image,contact,vector,document,dataset,capsule,provenance
- Audience:[agent:claude, human:alice, agent:*]
- Auto-signed on save if SIGNING_PRIVATE_KEY is set
- Provenance documents link to artwork pieces (certificate, sale, opinion, appraisal)

- humanMCP Marketplace— federated search across all humanMCP servers. Find listings, offers, trades by humans.MCP endpoint·Source
-
humanNetwork— wall-style aggregator showing chronological content from your followed humanMCP servers (stream.json preferred, MCP fallback)

Public links:read_blob slug:"kapoost-contact"— name, handle, github, instagram, facebook, landing page.

Private email:read_content slug:"kapoost-contact-private"— gated. Answer the challenge to access.

Every piece is signed with Ed25519.get_certificatereturns:

- SHA-256 content hash
- Ed25519 signature + public key
- Originality Index(0.0–1.0): burstiness (Fano Factor), lexical density (CTTR), Shannon entropy, structural signature — grades S/A/B/C/D
- License terms and price in sats (for commercial licenses)

- /.well-known/agent.json— agent profile card
- /.well-known/mcp-server.json— MCP server discovery
- /openapi.json— OpenAPI 3.1 spec (ChatGPT, Gemini)
- /llms.txt— LLM preferences (signed)
- /for-agents— agent onboarding page
- /connect— connection methods page

- GET /api/content— list all pieces
- GET /api/content/{slug}— read piece
- GET /api/search?q=...— full-text search
- GET /api/profile— author name, bio, tags
- GET /api/blobs— list data artifacts
- GET /listings/feed.json— listings feed
- GET /content/stream.json— unified content stream (pieces + listings, for humanNetwork)

- i18n— PL/EN language toggle on main page (EN default, stored in localStorage)
- License wizard— per-piece usage rules: what humans may do, what AI agents may do
- Artworks— photo upload, medium, dimensions, year, provenance documents
- Provenance— attach certificates, sale records, expert opinions to artworks (signed)
- ask_human— agents can ask the author questions privately (async Q&A, invisible to public)
- Federation— peer discovery vialist_peers/announce_peerMCP tools and/api/peersREST
- Dynamic sections— main page shows only sections with published content
- Free-form pricing— any currency, any format ("500 PLN", "$200", "trade only")

- Go 1.22, zero external dependencies
- Fly.io (region: waw), persistent volume at/data
- Ed25519 signing (stdlib crypto)
- Plain Markdown files as database
- No JS except 8-line drag-drop on/newpage

git clone https://github.com/kapoost/humanmcp-go.git cd humanmcp-go bash setup.sh

The script asks for your name and bio, then:

- Creates a Fly.io app (free tier)
- Generates Ed25519 signing keys
- Sets secrets and deploys
- Prints your login token and 1-click follow link

- https://yourname.humanmcp.net— your server
- https://yourname.humanmcp.net/connect— share with friends
- https://humanmcp.net/humannetwork.html?add=https://yourname.humanmcp.net— 1-click follow

go build ./cmd/server/ EDIT_TOKEN=secret AUTHOR_NAME=yourname ./server
fly launch --name yourname-humanmcp fly secrets set EDIT_TOKEN=secret AUTHOR_NAME=yourname fly deploy
go run ./cmd/keygen/ fly secrets set SIGNING_PRIVATE_KEY="..." SIGNING_PUBLIC_KEY="..."

- C2PA manifest embedding for blob files (when CA trust chain opens to individuals)
- Lightning Network payment gate for commercial licenses
- Scored conversational gate (agent brings API key, Claude evaluates answers)
- IP rate limiting + engagement tokens for anti-spam

136 tests across content, MCP, and upload/signature/license suites.

Chia Health MCP Server — Patient workflow integration for a licensed US telehealth platform. Browse GLP-1 medications (semaglutide, tirzepatide), peptide therapies (sermorelin, NAD+, glutathione), and longevity treatments. Check eligibility, complete intake, sign consents, and manage treatment plans. 30 tools, HIPAA-compliant. All prescriptions evaluated by licensed US healthcare providers and delivered from FDA-regulated pharmacies across 50 states + DC.

Broker + MCP server for last-bidder-wins games on Solana — agents register, auto-fund a Privy wallet, and bid via streamable HTTP

AI-powered no-code app builder with 17 MCP tools — create projects, generate pages from natural language, AI text/image generation (GPT, Claude, Gemini, 14+ models), page CRUD, workflow execution, publish & version control. SSE transport, API key auth.

An mcp server for your food ordering needs.

Agent-to-Agent handoff certification for multi-agent systems — validates context preservation, verifies agent capabilities before handoff, logs transfer chains, and ensures no data loss in agent orchestration.

Unified MCP & skill management gateway with progressive disclosure. Manages multiple MCP servers as Agent Apps, loading tool schemas on demand for 99% context token savings. Shared across Claude Code, Codex, OpenCode and more.

A collection of Model Context Protocol (MCP) servers for various tasks and integrations, supporting both Python and Node.js environments.

Open-souSecurely feeds real security refreshed rules into Cursor, Claude Code, and Windsurf — zero config, no API key.

Health intelligence MCP — access biomarkers, biological age, and personalized longevity action plans from your Aniva profile.

Real-time stock heatmaps and investment tools delivered as interactive React components.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.