PEP MCP Server

Instructions

Implementation Reference

• src/pep_mcp_server/server.py:25-39 (registration)

  Registration of the 'get_pep' tool in the MCP server.

  @mcp.tool
  async def get_pep(
      pep: int | str,
      query: str | None = None,
      max_full_content_chars: int | None = None,
  ) -> dict:
      """Get a PEP by number. Use ``query`` for excerpts; full body is capped by default.
  
      Pass ``max_full_content_chars=0`` for an uncapped full document (can be very large).
      """
      return await peps_client.get_pep_context(
          pep=pep,
          query=query,
          max_full_content_chars=max_full_content_chars,
      )

• src/pep_mcp_server/peps_client.py:52-95 (handler)

  Implementation of the 'get_pep_context' method in PepsClient, which handles the logic for the 'get_pep' tool.

  async def get_pep_context(
      self,
      pep: int | str,
      query: str | None = None,
      excerpt_context_lines: int = 3,
      max_full_content_chars: int | None = None,
  ) -> dict[str, Any]:
      """Return metadata and full content or focused excerpt for a single PEP."""
      pep_number = self._normalize_pep_number(pep)
      padded = self._pad_pep_number(pep_number)
      index = await self._get_index()
      metadata = index.get(str(pep_number), {})
  
      text = await self._fetch_pep_text(padded)
      result: dict[str, Any] = {
          "number": pep_number,
          "title": metadata.get("title"),
          "status": metadata.get("status"),
          "type": metadata.get("type"),
          "topic": metadata.get("topic"),
          "created": metadata.get("created"),
          "url": metadata.get("url"),
      }
  
      limit = self._resolve_full_content_limit(max_full_content_chars)
  
      query_value = (query or "").strip()
      if query_value:
          excerpt = self.extract_relevant_excerpt(
              text=text,
              query=query_value,
              context_lines=excerpt_context_lines,
          )
          result["query"] = query_value
          result["excerpt"] = excerpt
          result["content_truncated"] = bool(excerpt)
          if not excerpt:
              result["content"] = self._truncate_text(text, limit)
              result["content_truncated"] = result["content"] != text
          return result
  
      result["content"] = self._truncate_text(text, limit)
      result["content_truncated"] = result["content"] != text
      return result