Skip to content

docs(education): add MCP server to glossary - #1189

Open
Prab-27 wants to merge 3 commits into
apache:mainfrom
Prab-27:add-mcp-edu-doc
Open

docs(education): add MCP server to glossary#1189
Prab-27 wants to merge 3 commits into
apache:mainfrom
Prab-27:add-mcp-edu-doc

Conversation

@Prab-27

@Prab-27 Prab-27 commented Sep 9, 2026

Copy link
Copy Markdown

Summary

  • I read the docs and didn't know about it before and missed this that's why I believe it's related to glossary words of AI
  • Added an "MCP server" entry to the education glossary
  • Placed it after "Skill" since a skill uses an MCP server to act on external tools (GitHub, Slack, Gmail, etc.)

Type of change

  • Skill change (.claude/skills/<name>/) — eval fixtures updated below
  • Tool / bridge contract (tools/<system>/*.md)
  • Python package (tools/*/ with pyproject.toml)
  • Groovy reference impl
  • Cross-cutting (RFC, AGENTS.md, sandbox, privacy-LLM)
  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Project template (projects/_template/)
  • CI / dev loop (prek, workflows, validators)
  • Other:

Test plan

  • manually checked the existing entry to match the glossary words
  • ran prek hook locally
  • prek run --all-files passes
  • For Python packages touched: uv run pytest / ruff check / mypy passes
  • For Groovy bridges touched: command-line invocation tested end-to-end
  • For skill changes: eval suite passes for the affected skill
    (PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/)
  • For skill behaviour changes: a new or updated eval fixture is included in this PR
    (a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md)
  • Other:

RFC-AI-0004 compliance

  • HITL — any new mutation is gated on explicit user confirmation
  • Sandbox — no new unrestricted host access; network reach declared in the adapter
  • Vendor neutrality — placeholders (<PROJECT>, <tracker>, <upstream>, <security-list>) used in all skill / tool prose (the check-placeholders prek hook is the mechanical gate)
  • Conversational + correctable — agentic-override path documented if behaviour is adopter-tunable
  • Write-access discipline — no autonomous outbound messages; drafts only, sent on confirmation
  • Privacy LLM — private content does not reach a non-approved LLM; redactor invoked where needed

Linked issues

Notes for reviewers (optional)

Why: the glossary defines Agent and Skill but never MCP server, even
though skills rely on MCP servers to reach external tools like
GitHub, Slack, and Gmail. Adds a plain-English definition consistent
with the existing glossary style, placed after "Skill" since MCP is
what a skill uses to act on the outside world.
why: the file was accidently commited so revert it and commit with no functional change
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.

2 participants