Skip to main content
Glama
jacksonxbxt

founders-archive-mcp

by jacksonxbxt

Founders Transcript Archive

Founders 팟캐스트 대본의 개인 아카이브를 구축, 검증, 검색, 조회하기 위한 로컬 우선(local-first) 시스템입니다. 재개 가능한 아카이브 파이프라인과 전체 텍스트 및 의미론적 검색, 명령줄 인터페이스, MCP 서버, Codex 리서치 스킬을 결합합니다.

공개 범위

이 저장소에는 소프트웨어, 테스트, 운영 문서가 포함되어 있습니다. 팟캐스트 대본, 인덱스, 오디오, API 자격 증명 또는 기타 생성된 아카이브 데이터는 포함되어 있지 않습니다. 이러한 산출물은 Git에서 제외된 data/ 디렉터리에 있으며 비공개로 유지되어야 합니다. 사용자는 적용 가능한 약관과 권리에 따라 원본 자료를 획득하고 사용할 책임이 있습니다.

Related MCP server: recall-mcp

기능

  • 공개 Megaphone RSS 피드에서 표준 에피소드 카탈로그를 확인합니다.

  • 명시적으로 상한이 설정된 재개 가능한 Spoken 워크플로를 통해 대본을 가져옵니다.

  • 대본이 없을 때 로컬 Apple Silicon 전사를 대체 수단으로 사용합니다.

  • SQLite 상태/검색 인덱스와 함께 이식 가능한 Markdown 및 JSON 산출물을 저장합니다.

  • 카탈로그 범위, 체크섬, 산출물 무결성을 검증합니다.

  • 하이브리드 FTS5 및 의미론적 검색으로 인용 구절 인덱스를 구축합니다.

  • CLI 또는 founders-archive-mcp stdio 서버를 통해 조회합니다.

요구 사항

  • Python 3.12 이상

  • uv

  • 선택 사항: 로컬 전사를 위한 Apple Silicon 및 local 종속성 그룹

설정

git clone https://github.com/jacksonxbxt/founders-transcript-archive.git
cd founders-transcript-archive
uv sync --extra research
uv run --extra research --with pytest pytest -q

대본 크레딧을 소모하지 않고 아카이브 동기화를 미리 봅니다:

uv run --extra local founders-archive sync --dry-run --archive-root data

비공개 리서치 인덱스를 구축하고 인용 조회를 실행합니다:

uv run --extra research founders-archive index --archive-root data
uv run --extra research founders-archive research \
  "maintaining control while financing growth" \
  --archive-root data --limit 8 --json

전체 운영 워크플로와 안전 제약 사항은 PROJECT_PLAYBOOK.md를 참조하세요.

라이선스

선택된 오픈소스 라이선스가 없습니다. 공개적으로 표시된다고 해서 코드나 기반 콘텐츠를 복사, 수정, 재배포할 수 있는 라이선스가 부여되는 것은 아닙니다.

Available Tools

4 tools
find_founders_episodeA

Find Founders episodes by exact episode number or partial title.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
queryYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must carry the burden of behavioral disclosure. It does add the key matching rule (exact number or partial title), which is a meaningful behavioral trait. However, it does not mention pagination, result type, or any side effects. The existence of an output schema reduces some burden, but safety or read-only behavior is not disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-formed sentence that states the action and the method without any wasted words. It is front-loaded with the action and efficiently communicates the core behavior.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple lookup tool with an output schema, the description covers the main input semantics and the matching rule. However, it lacks usage guidance and does not mention alternatives, which slightly reduces completeness. Given the tool's simplicity and the presence of an output schema, this is adequate but not exhaustive.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It clarifies that `query` accepts an exact episode number or a partial title, giving concrete meaning to the otherwise bare string parameter. The `limit` parameter is not explicitly explained, but its purpose (limiting results) is self-evident. Overall, the description adds significant meaning to the main parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'Find' with a clear resource ('Founders episodes') and states the method ('by exact episode number or partial title'). This distinguishes it from a generic search, but it does not explicitly name or contrast with sibling tools like `search_founders`, so it stops short of full differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when the user has an exact episode number or a partial title, but it provides no explicit guidance on when *not* to use this tool or which alternative (e.g., `search_founders`) to choose. The usage context is inferred, not stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

founders_archive_statusA

Check whether the private transcript corpus and hybrid research index are ready.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of disclosing behavior. It indicates a read-only status check ('check whether'), but does not describe what the response contains (e.g., boolean, detail object, error conditions) or any side effects (likely none). Since an output schema exists, some return details are covered structurally, but the description adds little beyond the action itself.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, tightly worded sentence that front-loads the core action and object. No filler, no repetition, and every word contributes to the meaning. Ideal for a status-check tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the zero-parameter surface, the presence of an output schema, and the clear distinction from sibling tools, the description fully specifies what the tool does. There is no missing information an agent needs to decide to call it or interpret its result beyond what the schema already provides.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so there is nothing to document. Per the baseline guidance, a 4 is appropriate when there are no parameters to describe; the description correctly avoids fabricating parameter details and focuses on the tool's purpose.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action ('check whether') and names the exact resources checked ('private transcript corpus and hybrid research index'). This clearly distinguishes it from the sibling search/fetch tools, so an agent can tell at a glance this is a readiness probe rather than a data-access operation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies a preflight role (checking readiness before using the search tools) but does not explicitly say 'use before searching' or mention when not to use it. It gives the purpose but no direct guidance on when to call it versus alternatives, leaving the agent to infer the gate-keeping scenario.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_founders_passageA

Expand a cited passage with up to three neighboring passages from the same episode.

ParametersJSON Schema
NameRequiredDescriptionDefault
contextNo
passage_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It does state the core behavior ('expand a cited passage with up to three neighboring passages'), giving the upper bound. However, it doesn't disclose whether the operation is read-only, what happens when no neighbors exist, or how the 'context' parameter modifies the behavior. The description is not misleading, but it lacks depth that would be valuable given zero annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that front-loads the primary function ('expand a cited passage') and immediately states the limit ('up to three neighboring passages'). There is zero waste, and every word contributes to understanding the tool's core purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema, the description is insufficient for a simple tool with 0% schema description coverage. It fails to explain the 'context' parameter or clarify what 'neighboring passages' means (e.g., previous/next, one each side). An agent might not know how to control the number of passages returned or whether the default behavior meets the stated 'up to three' limit. This leaves critical usage details ambiguous.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must explain the parameters. It never mentions 'context' at all, leaving its meaning (likely number of neighbors) opaque. 'passage_id' is only implied by 'cited passage' but not explicitly tied to the parameter. The description adds almost no value beyond the bare schema names, failing to compensate for the missing schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('expand') and a clear resource ('cited passage'), and adds precise scope ('up to three neighboring passages from the same episode'). This clearly distinguishes it from siblings like search_founders (searching) and find_founders_episode (finding an episode).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies a clear use case: when you have a cited passage and want to see its neighbors for context. It doesn't explicitly name alternatives or state when not to use it, but the purpose is distinct enough that an agent would know when to invoke it. This qualifies as clear context without explicit exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_foundersC

Find cited evidence for a strategic question. Run reframed and conflicting-view searches before synthesizing.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
queryYes
episode_numberNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It does not state whether this is a read-only search, what scope it searches (episodes? full archive?), how results are ordered, or what side effects exist. An output schema covers return shape, but operation semantics remain undocumented.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, zero filler, and the primary purpose is front-loaded before the workflow note. Every sentence earns its place; there is no redundancy with the schema or siblings.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, which relieves the description of explaining return values, and sibling names provide context. However, with 0% parameter documentation, no annotations, and a domain-specific parameter like episode_number left unexplained, the description is not complete enough for an agent to call this tool correctly in all intended cases.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, yet it says nothing about any of the three parameters. Required 'query' is not qualified (format, reframing strategy), and 'episode_number' — which clearly scopes the search to a single episode — is never mentioned, leaving agents to guess its semantics from the bare schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a clear verb ('Find') and resource ('cited evidence') tied to a strategic-question context, so an agent understands the core purpose. However, it does not differentiate from the sibling 'get_founders_passage', which plausibly also returns passages/evidence, leaving the boundary between the two tools implicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'Run reframed and conflicting-view searches before synthesizing' gives workflow-ordering guidance (use it before synthesis) but says nothing about when to prefer this tool over its siblings, nor when not to use it. No alternatives are named and no conditions select one tool over another.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 4 tool updatesv0.1.0
    • First observedfind_founders_episode
    • First observedfounders_archive_status
    • First observedget_founders_passage
    • First observedsearch_founders

TDQS

A3.7/5.0

Scored across 4 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: status check, search for evidence, expand a passage, and locate an episode. No overlap or ambiguity between them.

Naming Consistency5/5

All tools follow a consistent verb_noun snake_case pattern (search_founders, get_founders_passage, find_founders_episode) with the exception of founders_archive_status which uses a noun, but it still reads clearly and the pattern is uniform.

Tool Count5/5

Four tools is well-scoped for this server's purpose. Each one earns its place, covering the essential research workflows without bloat.

Completeness4/5

The server covers status, search, passage expansion, and episode lookup, which are sufficient for core research tasks. A minor gap is the lack of a browse/list function for episodes, but the existing tools handle the primary use cases.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Local-first RAG indexing and semantic search MCP server. Enables document retrieval and context-aware queries using local embedding models.
    3
    13 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Local semantic search MCP server for markdown docs and Granola meeting transcripts that runs entirely on your machine with no API keys, no cloud, and no cost.
    7 npm
    5
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides MCP tools for semantic search over personal knowledge sources using pluggable embeddings and local vector indexing.
    1
    MIT