@zonuexe/techbook-mcp 0.1.0

package/src/adapters/publishers/techbookfest.ts

@@ -0,0 +1,179 @@
+import type { PublisherAdapter, PublisherDeps } from "../../domain/publisher.js";
+import type { BookRecord, SearchQuery } from "../../domain/book.js";
+import { fetchText, parseJapanesePrice, extractEbookStoresFromDoc } from "./base.js";
+
+const BASE_URL = "https://techbookfest.org";
+const GRAPHQL_URL = `${BASE_URL}/api/graphql`;
+const XSRF_CACHE_KEY = "techbookfest:xsrf-token";
+const XSRF_TTL_SECONDS = 3600;
+
+const DEFAULT_HEADERS = {
+  "User-Agent": "techbook-mcp/0.1.0 (+https://github.com/zonuexe/techbook-mcp; bibliographic search bot)",
+  "Accept": "application/json",
+};
+
+// node.product は ProductInfoSearchResult のインラインフラグメント経由でアクセスする
+const SEARCH_QUERY = `
+query MarketSearchQuery($query: String!, $first: Int!) {
+  searchProducts(first: $first, query: $query, orderBy: CREATED_AT_DESC) {
+    pageInfo { hasNextPage endCursor }
+    edges {
+      node {
+        ... on ProductInfoSearchResult {
+          product {
+            id
+            databaseID
+            name
+            description
+            organization { name }
+            coverImage { url }
+            ebookVariant: productVariant(kind: MARKET_EBOOK) { price }
+            firstPublishedAt
+            status
+          }
+        }
+      }
+    }
+  }
+}
+`.trim();
+
+interface TechbookfestProduct {
+  id: string;
+  databaseID: string;
+  name: string;
+  description: string | null;
+  organization: { name: string } | null;
+  coverImage: { url: string } | null;
+  ebookVariant: { price: number } | null;
+  firstPublishedAt: string | null;
+  status: string;
+}
+
+interface GraphQLResponse {
+  data?: {
+    searchProducts?: {
+      edges: Array<{ node: { product?: TechbookfestProduct } }>;
+    };
+  };
+}
+
+/**
+ * トップページの Set-Cookie から XSRF-TOKEN を取得してキャッシュする。
+ * 技術書典の GraphQL API は XSRF トークンを Cookie + X-XSRF-TOKEN ヘッダーの
+ * ダブルサブミット方式で検証する。
+ */
+async function fetchXsrfToken(deps: PublisherDeps): Promise<string> {
+  const cached = await deps.cache.get(XSRF_CACHE_KEY);
+  if (cached !== null) return cached;
+
+  const response = await deps.http.get(BASE_URL, { headers: DEFAULT_HEADERS });
+  const setCookie = response.header("set-cookie") ?? "";
+
+  // Set-Cookie: XSRF-TOKEN=<urlencoded-value>; Path=/; Secure; SameSite=Lax
+  const match = setCookie.match(/XSRF-TOKEN=([^;,\s]+)/);
+  if (!match) throw new Error("techbookfest: XSRF-TOKEN not found in Set-Cookie");
+
+  const token = decodeURIComponent(match[1]);
+  await deps.cache.set(XSRF_CACHE_KEY, token, XSRF_TTL_SECONDS);
+  return token;
+}
+
+function productToBookRecord(product: TechbookfestProduct): BookRecord {
+  const url = `${BASE_URL}/product/${product.databaseID}`;
+  const publishedAt = product.firstPublishedAt
+    ? product.firstPublishedAt.slice(0, 10)
+    : undefined;
+
+  return {
+    title: product.name,
+    authors: product.organization ? [product.organization.name] : [],
+    publisher: "技術書典",
+    url,
+    price: product.ebookVariant?.price,
+    description: product.description ?? undefined,
+    coverImageUrl: product.coverImage?.url,
+    publishedAt,
+    ebookStores: [{ name: "技術書典", url, drm: "free" }],
+  };
+}
+
+export const techbookfestAdapter: PublisherAdapter = {
+  id: "techbookfest",
+  name: "技術書典オンラインマーケット",
+  baseUrl: BASE_URL,
+
+  async search(query: SearchQuery, deps: PublisherDeps): Promise<BookRecord[]> {
+    const word = [query.title, query.author].filter(Boolean).join(" ");
+    if (!word) return [];
+
+    const limit = query.limit ?? 10;
+    const xsrf = await fetchXsrfToken(deps);
+
+    const body = JSON.stringify({
+      operationName: "MarketSearchQuery",
+      query: SEARCH_QUERY,
+      variables: { query: word, first: limit },
+    });
+
+    const response = await deps.http.post(GRAPHQL_URL, body, {
+      headers: {
+        ...DEFAULT_HEADERS,
+        "Content-Type": "application/json",
+        "Cookie": `XSRF-TOKEN=${encodeURIComponent(xsrf)}`,
+        "X-XSRF-TOKEN": xsrf,
+      },
+    });
+
+    if (response.status !== 200) {
+      throw new Error(`HTTP ${response.status}: ${GRAPHQL_URL}`);
+    }
+
+    const json = JSON.parse(await response.text()) as GraphQLResponse;
+    const edges = json.data?.searchProducts?.edges ?? [];
+
+    return edges
+      .map(e => e.node.product)
+      .filter((p): p is TechbookfestProduct => p != null)
+      .slice(0, limit)
+      .map(productToBookRecord);
+  },
+
+  async getDetail(url: string, deps: PublisherDeps): Promise<BookRecord> {
+    const html = await fetchText(url, deps);
+    const doc = deps.parser.parse(html);
+
+    const title =
+      doc.selectOne('meta[property="og:title"]')?.attr("content") ??
+      doc.selectOne("h1")?.text() ??
+      "";
+
+    const description =
+      doc.selectOne('meta[property="og:description"]')?.attr("content") ??
+      doc.selectOne('meta[name="description"]')?.attr("content") ??
+      undefined;
+
+    const coverImageUrl =
+      doc.selectOne('meta[property="og:image"]')?.attr("content") ??
+      undefined;
+
+    const priceText = doc.selectOne('[class*="price"]')?.text();
+    const price = priceText ? parseJapanesePrice(priceText) : undefined;
+
+    const ebookStores = extractEbookStoresFromDoc(doc);
+    if (!ebookStores.some(s => s.name === "技術書典")) {
+      ebookStores.unshift({ name: "技術書典", url, drm: "free" });
+    }
+
+    return {
+      title,
+      authors: [],
+      publisher: "技術書典",
+      url,
+      price,
+      description,
+      coverImageUrl,
+      ebookStores,
+    };
+  },
+};

package/src/application/get-book-detail.ts

@@ -0,0 +1,17 @@
+import type { BookRecord } from "../domain/book.js";
+import type { PublisherAdapter, PublisherDeps } from "../domain/publisher.js";
+
+export async function getBookDetail(
+  url: string,
+  publishers: readonly PublisherAdapter[],
+  deps: PublisherDeps,
+): Promise<BookRecord> {
+  const publisher = publishers.find(p => url.startsWith(p.baseUrl));
+  if (!publisher) {
+    throw new Error(
+      `このURLに対応する出版社アダプターがありません: ${url}\n` +
+      `対応URL: ${publishers.map(p => p.baseUrl).join(", ")}`,
+    );
+  }
+  return publisher.getDetail(url, deps);
+}

package/src/application/search-books.ts

@@ -0,0 +1,39 @@
+import type { BookRecord, SearchQuery } from "../domain/book.js";
+import type { PublisherAdapter, PublisherDeps } from "../domain/publisher.js";
+
+export interface SearchBooksResult {
+  books: BookRecord[];
+  errors: Array<{ publisherId: string; message: string }>;
+}
+
+export async function searchBooks(
+  query: SearchQuery,
+  publishers: readonly PublisherAdapter[],
+  deps: PublisherDeps,
+): Promise<SearchBooksResult> {
+  const targets = query.publisherId
+    ? publishers.filter(p => p.id === query.publisherId)
+    : publishers;
+
+  const results = await Promise.allSettled(
+    targets.map(p => p.search(query, deps)),
+  );
+
+  const books: BookRecord[] = [];
+  const errors: Array<{ publisherId: string; message: string }> = [];
+
+  for (let i = 0; i < results.length; i++) {
+    const result = results[i];
+    const publisher = targets[i];
+    if (result.status === "fulfilled") {
+      books.push(...result.value);
+    } else {
+      const message = result.reason instanceof Error
+        ? result.reason.message
+        : String(result.reason);
+      errors.push({ publisherId: publisher.id, message });
+    }
+  }
+
+  return { books, errors };
+}

package/src/domain/book.ts

@@ -0,0 +1,35 @@
+/**
+ * - `"free"`         : 技術的DRMなし (DRM-free PDF/EPUB)
+ * - `"social"`       : ソーシャルDRM (購入者情報を透かし刻印、技術的制限なし)
+ * - `"password_pdf"` : パスワード認証付きPDF (標準PDFビューアで閲覧可、パスワード必須)
+ * - `"drm"`          : 技術的DRM付き (専用ビューアー必須)
+ */
+export type DrmType = "free" | "social" | "password_pdf" | "drm";
+
+export interface EbookStore {
+  name: string;
+  url: string;
+  drm: DrmType;
+}
+
+export interface BookRecord {
+  title: string;
+  authors: string[];
+  publisher: string;
+  publishedAt?: string;   // "YYYY-MM-DD"
+  isbn?: string;          // ISBN-13、ハイフンなし数字のみ
+  asin?: string;          // Amazon ASIN (Amazonリンクが存在する場合)
+  url: string;            // 出版社公式ページURL
+  price?: number;         // 税込価格（円）
+  coverImageUrl?: string;
+  description?: string;
+  tags?: string[];
+  ebookStores?: EbookStore[];
+}
+
+export interface SearchQuery {
+  title?: string;
+  author?: string;
+  publisherId?: string;  // 出版社IDでフィルタ (例: "gihyo", "lambdanote")
+  limit?: number;        // デフォルト: 10
+}

package/src/domain/publisher.ts

@@ -0,0 +1,18 @@
+import type { BookRecord, SearchQuery } from "./book.js";
+import type { HttpClient } from "../ports/http.js";
+import type { HtmlParser } from "../ports/html-parser.js";
+import type { CacheStore } from "../ports/cache.js";
+
+export interface PublisherDeps {
+  http: HttpClient;
+  parser: HtmlParser;
+  cache: CacheStore;
+}
+
+export interface PublisherAdapter {
+  readonly id: string;
+  readonly name: string;
+  readonly baseUrl: string;
+  search(query: SearchQuery, deps: PublisherDeps): Promise<BookRecord[]>;
+  getDetail(url: string, deps: PublisherDeps): Promise<BookRecord>;
+}

package/src/main.ts

@@ -0,0 +1,13 @@
+import { startServer } from "./mcp/server.js";
+import { DEFAULT_PUBLISHERS } from "./adapters/publishers/registry.js";
+import { FetchHttpClient } from "./adapters/http/fetch-client.js";
+import { CheerioHtmlParser } from "./adapters/html/cheerio-parser.js";
+import { MemoryCacheStore } from "./adapters/cache/memory-cache.js";
+
+const deps = {
+  http: new FetchHttpClient(),
+  parser: new CheerioHtmlParser(),
+  cache: new MemoryCacheStore(),
+};
+
+await startServer(DEFAULT_PUBLISHERS, deps);

package/src/mcp/server.ts

@@ -0,0 +1,103 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import type { PublisherAdapter, PublisherDeps } from "../domain/publisher.js";
+import type { BookRecord, EbookStore, DrmType, SearchQuery } from "../domain/book.js";
+import { searchBooks } from "../application/search-books.js";
+import { getBookDetail } from "../application/get-book-detail.js";
+import { TOOLS } from "./tools.js";
+
+// --- 出力フォーマット ---
+
+const DRM_LABELS: Record<DrmType, string> = {
+  free:         "DRMフリー",
+  social:       "DRMフリー (ソーシャル)",
+  password_pdf: "パスワード付きPDF",
+  drm:          "DRM付き",
+};
+
+function formatEbookStore(store: EbookStore): Record<string, unknown> {
+  return { ...store, drmLabel: DRM_LABELS[store.drm] };
+}
+
+function formatBook(book: BookRecord): Record<string, unknown> {
+  if (!book.ebookStores) return book as unknown as Record<string, unknown>;
+  return { ...book, ebookStores: book.ebookStores.map(formatEbookStore) };
+}
+
+export function createServer(
+  publishers: readonly PublisherAdapter[],
+  deps: PublisherDeps,
+): Server {
+  const server = new Server(
+    {
+      name: "@zonuexe/techbook-mcp",
+      version: "0.1.0",
+    },
+    {
+      capabilities: { tools: {} },
+    },
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+  }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+
+    switch (name) {
+      case "search_books": {
+        const query: SearchQuery = {
+          title: typeof args["title"] === "string" ? args["title"] : undefined,
+          author: typeof args["author"] === "string" ? args["author"] : undefined,
+          publisherId: typeof args["publisher"] === "string" ? args["publisher"] : undefined,
+          limit: typeof args["limit"] === "number" ? Math.min(args["limit"], 50) : 10,
+        };
+        const { books, errors } = await searchBooks(query, publishers, deps);
+        const output: Record<string, unknown> = { books: books.map(formatBook) };
+        if (errors.length > 0) output["errors"] = errors;
+        return {
+          content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+        };
+      }
+
+      case "get_book_detail": {
+        const url = args["url"];
+        if (typeof url !== "string") throw new Error("url は必須です");
+        const book = await getBookDetail(url, publishers, deps);
+        return {
+          content: [{ type: "text", text: JSON.stringify(formatBook(book), null, 2) }],
+        };
+      }
+
+      case "list_publishers": {
+        const list = publishers.map(p => ({
+          id: p.id,
+          name: p.name,
+          baseUrl: p.baseUrl,
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify(list, null, 2) }],
+        };
+      }
+
+      default:
+        throw new Error(`未知のツール: ${name}`);
+    }
+  });
+
+  return server;
+}
+
+export async function startServer(
+  publishers: readonly PublisherAdapter[],
+  deps: PublisherDeps,
+): Promise<void> {
+  const server = createServer(publishers, deps);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}

package/src/mcp/tools.ts

@@ -0,0 +1,54 @@
+export const TOOLS = [
+  {
+    name: "search_books",
+    description:
+      "書名・著者名から日本語技術書を検索し、書誌情報の一覧を返します。" +
+      "複数の出版社を横断して検索します。",
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: {
+          type: "string",
+          description: "書名（部分一致）",
+        },
+        author: {
+          type: "string",
+          description: "著者名（部分一致）",
+        },
+        publisher: {
+          type: "string",
+          description:
+            "出版社IDで検索対象を絞り込みます。指定しない場合は全出版社を検索します。" +
+            "利用可能なIDは list_publishers で確認できます。",
+        },
+        limit: {
+          type: "number",
+          description: "1出版社あたりの最大取得件数（デフォルト: 10、最大: 50）",
+          default: 10,
+        },
+      },
+    },
+  },
+  {
+    name: "get_book_detail",
+    description: "書籍の公式ページURLから詳細な書誌情報を取得します。",
+    inputSchema: {
+      type: "object",
+      required: ["url"],
+      properties: {
+        url: {
+          type: "string",
+          description: "書籍の公式ページURL（出版社サイトのURL）",
+        },
+      },
+    },
+  },
+  {
+    name: "list_publishers",
+    description: "対応している出版社の一覧とIDを返します。",
+    inputSchema: {
+      type: "object",
+      properties: {},
+    },
+  },
+] as const;

package/src/ports/cache.ts

@@ -0,0 +1,5 @@
+export interface CacheStore {
+  get(key: string): Promise<string | null>;
+  set(key: string, value: string, ttlSeconds?: number): Promise<void>;
+  delete(key: string): Promise<void>;
+}

package/src/ports/html-parser.ts

@@ -0,0 +1,15 @@
+export interface HtmlElement {
+  text(): string;
+  html(): string | null;
+  attr(name: string): string | undefined;
+  find(selector: string): HtmlElement[];
+}
+
+export interface HtmlDocument {
+  select(selector: string): HtmlElement[];
+  selectOne(selector: string): HtmlElement | null;
+}
+
+export interface HtmlParser {
+  parse(html: string): HtmlDocument;
+}

package/src/ports/http.ts

@@ -0,0 +1,17 @@
+export interface RequestOptions {
+  headers?: Record<string, string>;
+  timeout?: number;
+}
+
+export interface HttpResponse {
+  readonly status: number;
+  readonly url: string;
+  text(): Promise<string>;
+  /** ヘッダー値を取得する。複数値は `, ` 結合。存在しない場合は null。 */
+  header(name: string): string | null;
+}
+
+export interface HttpClient {
+  get(url: string, options?: RequestOptions): Promise<HttpResponse>;
+  post(url: string, body: string, options?: RequestOptions): Promise<HttpResponse>;
+}

package/tests/fixtures/book-tech-detail.html

@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html lang="ja">
+<head><meta charset="utf-8"><title>BOOK TECH | 次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ</title></head>
+<body>
+<div class="contents-base">
+  <div class="contents-book">
+    <div class="contents-book-inner">
+      <div class="contents-book-item">
+        <div class="contents-book-item-detail-wrap">
+          <div class="contents-book-item-detail-thumb">
+            <img src="https://booktech-share.s3-ap-northeast-1.amazonaws.com/books/d80ffe3d.webp" class="thumb" alt="次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ">
+          </div>
+          <div class="contents-book-item-detail-price_include_tax">
+            2,178円<span class="tax">（税込）</span>
+          </div>
+        </div>
+      </div>
+
+      <div class="contents-book-about">
+        <div class="contents-book-about-title">
+          <h1>次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ</h1>
+        </div>
+
+        <div class="contents-book-about-publicationdate my-1" style="font-size: 0.85em;">
+          発売日:
+          2026/2/20
+        </div>
+
+        <div class="d-flex flex-wrap align-items-center gap-1">
+          <a class="badge bg-light text-dark border" href="/books?q%5Bpublisher_relations_publisher_id_in%5D%5B%5D=4">
+            <i class="fas fa-building me-1"></i>インプレス NextPublishing
+          </a>
+          <a class="badge bg-light text-dark border" href="/books?q%5Bauthor_relations_author_id_in%5D%5B%5D=2205">
+            <i class="fas fa-user me-1"></i>philosophy (著)
+          </a>
+        </div>
+
+        <div class="contents-book-about-id" style="font-size: 0.85em;">
+          ISBN:
+          9784295604136
+        </div>
+
+        <div class="contents-book-about-description scroll">
+          TypeScriptによる型安全な開発、各種ホスティングサービスへの公開方法などを解説します。
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+</body>
+</html>

package/tests/fixtures/book-tech-search.html

@@ -0,0 +1,91 @@
+<!DOCTYPE html>
+<html lang="ja">
+<head><meta charset="utf-8"><title>BOOK TECH | 「TypeScript」の検索結果</title></head>
+<body>
+<div class="contents-base">
+  <div class="contents-index">
+    <div class="contents-index-wrap">
+
+      <div class="contents-index-item">
+        <div class="contents-index-item-lang">
+          <a class="contents-index-item-large-lang-wrap" href="/books?q%5Bbook_category_in%5D%5B%5D=%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF%E3%83%BBIT">コンピュータ・IT</a>
+        </div>
+        <div class="contents-index-item-detail-wrap">
+          <div class="contents-index-item-detail">
+            <div class="contents-index-item-detail-thumb">
+              <a class="book-ribbon-link" href="/books/d80ffe3d-f3fe-458b-95ee-b4dd3327fab2">
+                <img src="https://booktech-share.s3-ap-northeast-1.amazonaws.com/books/d80ffe3d.webp" class="thumb" alt="次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ">
+              </a>
+            </div>
+          </div>
+          <div class="contents-index-item-detail">
+            <div class="contents-index-item-detail-title">
+              次のステップへ！React実践開発　サクサク作って学ぶ UI/テスト/デプロイ
+            </div>
+            <div class="my-1" style="font-size: 0.85em;">
+              発売日: 2026/2/20
+            </div>
+            <div class="d-none d-lg-block d-flex flex-wrap align-items-center gap-1">
+              <a class="badge bg-light text-dark border" href="/books?q%5Bpublisher_relations_publisher_id_in%5D%5B%5D=4">
+                <i class="fas fa-building me-1"></i>インプレス NextPublishing
+              </a>
+              <a class="badge bg-light text-dark border" href="/books?q%5Bauthor_relations_author_id_in%5D%5B%5D=2205">
+                <i class="fas fa-user me-1"></i>philosophy (著)
+              </a>
+            </div>
+            <div class="contents-index-item-detail-description scroll">
+              TypeScriptによる型安全な開発を解説します。
+            </div>
+            <div class="contents-index-item-detail-price_include_tax">
+              <div>
+                2,178円<span class="tax">（税込）</span>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <div class="contents-index-item">
+        <div class="contents-index-item-lang">
+          <a class="contents-index-item-large-lang-wrap" href="/books?q%5Bbook_category_in%5D%5B%5D=%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF%E3%83%BBIT">コンピュータ・IT</a>
+        </div>
+        <div class="contents-index-item-detail-wrap">
+          <div class="contents-index-item-detail">
+            <div class="contents-index-item-detail-thumb">
+              <a class="book-ribbon-link" href="/books/a52f6467-5d0c-4d76-9351-19a0ab76eb96">
+                <img src="https://booktech-share.s3-ap-northeast-1.amazonaws.com/books/a52f6467.webp" class="thumb" alt="React環境構築の教科書">
+              </a>
+            </div>
+          </div>
+          <div class="contents-index-item-detail">
+            <div class="contents-index-item-detail-title">
+              React環境構築の教科書
+            </div>
+            <div class="my-1" style="font-size: 0.85em;">
+              発売日: 2020/8/21
+            </div>
+            <div class="d-none d-lg-block d-flex flex-wrap align-items-center gap-1">
+              <a class="badge bg-light text-dark border" href="/books?q%5Bpublisher_relations_publisher_id_in%5D%5B%5D=4">
+                <i class="fas fa-building me-1"></i>インプレス NextPublishing
+              </a>
+              <a class="badge bg-light text-dark border" href="/books?q%5Bauthor_relations_author_id_in%5D%5B%5D=107">
+                <i class="fas fa-user me-1"></i>井手 優太 (著)
+              </a>
+            </div>
+            <div class="contents-index-item-detail-description scroll">
+              TypeScriptを使ったコンパイル環境を解説します。
+            </div>
+            <div class="contents-index-item-detail-price_include_tax">
+              <div>
+                3,300円<span class="tax">（税込）</span>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+
+    </div>
+  </div>
+</div>
+</body>
+</html>