FastMCP "Hello World" MCP

Kurulum

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Çalıştırma (STDIO)

python3 server.py

Tool

• hello(name: str = "world") -> str
• rag_search(query: str, query_embedding: list[float], top_k: int = 5) -> dict
• team_faq_lookup(question: str, question_embedding: list[float], top_k: int = 5) -> dict

RAG / pgvector ayarları

Gerekli environment değişkenleri:

• DATABASE_URL: postgres://user:pass@host:5432/dbname
• PGVECTOR_TABLE (varsayılan documents)
• PGVECTOR_ID_COL (varsayılan id)
• PGVECTOR_CONTENT_COL (varsayılan content)
• PGVECTOR_EMBEDDING_COL (varsayılan embedding)
• FAQ_MAX_DISTANCE (varsayılan 0.25): en iyi eşleşmenin “cevap var” sayılması için maksimum distance (küçük daha iyi)

Beklenen minimum tablo şeması (örnek):

create extension if not exists vector;

create table if not exists documents (
  id bigserial primary key,
  content text not null,
  embedding vector(1536) not null
);

create index if not exists documents_embedding_idx
  on documents using ivfflat (embedding vector_cosine_ops);