mcp-server

The MCP server that delivers the LXAgents shared agent instruction set. A repository connects it as a connector and reads the conventions it needs — branching, commits, pull requests, task workflow, the creators, the directory architecture — instead of cloning or vendoring a copy of them.

• Server id: lxagents-agents-base
• Package: @lxagents/agents-base
• Surface: MCP prompts and resources, plus four read-only tools for clients that only enumerate tools.

Key features

• agents-setup prompt — the full setup procedure that builds a repository's AGENTS.md, .agents/ tree, wiki, and memory.
• check-duplicate-agents-instruction prompt — finds instructions a repository duplicates from the shared set and removes them. Runs only when asked.
• 25 instruction resources under agents://, plus agents://manifest.json listing every file with a content hash — one read instead of walking the set.
• Four read-only tools — agents_setup, agents_check_duplicate_instructions, agents_list_instructions, agents_read_instruction — delivering the same content as the prompts, for clients that surface tools only.
• Many clients at once. Content is loaded once into a frozen registry; each request or session gets its own server instance, so nothing is shared and any process can serve any request.

Quick start

npm install
npm test

# Local, over stdio
npm start

# Remote connector surface, over streamable HTTP
npm run start:http     # http://localhost:3000/mcp

With Docker:

docker compose up --build

Connect it

Add a custom connector pointing at https://<host>/mcp, named lxagents-agents-base. Include the /mcp path — without it the handshake fails, and clients report that as a sign-in error rather than a wrong address. For local development over stdio, see wiki/guides/connect-a-repository.md.

Documentation

• Overview — what this serves and why it is a server.
• Architecture — registry, transports, concurrency.
• MCP surface — every prompt and resource.
• Local setup — running and testing it.

Working with agents

The instruction set this server delivers is also the instruction set this repository follows. Start at AGENTS.md; the canonical content lives in content/.

License

MIT — see LICENSE.