An MCP server running on Cloudflare Workers that provides calculation tools and integrations with FastAPI/Langchain services for blog generation
Server has 4 tools with explicit Zod schemas and descriptions, but quality is inconsistent. Tools 1 - 2 (add, calculate) are well-defined with clear schemas and English descriptions. Tools 3 - 4 (langchain_request, generate_blog) have complex schemas but descriptions are in Japanese, limiting LLM comprehension. Parameter descriptions are present but sparse (avg ~40 chars vs baseline 72). No output schemas documented. Error handling is present but generic ('エラー: ...'). Tool naming follows verb_noun pattern but lacks clarity on when to use langchain_request vs generate_blog, both call external APIs but serve different purposes.
シンプルな足し算。2つの数値を受け取り、その合計を返します
多機能計算機。加算、減算、乗算、除算の演算をサポートします
ブログ生成専用ツール。FastAPI/Langchainのブログ生成エンドポイントに特化したツール
FastAPI/Langchain統合。Langchainを実行する外部のFastAPIサーバーにリクエストを送信します
Descriptions in Japanese limit LLM comprehension. All tool and parameter descriptions should be in English for cross-language LLM compatibility.
No output schemas documented. LLMs cannot plan downstream calls or extract structured data from responses. Document return types for all tools.
Overlapping tool purposes: langchain_request is a generic HTTP proxy, while generate_blog is a specialized wrapper. Unclear when to use each. Consider consolidating or clarifying the distinction.
API keys exposed as optional parameters (api_key in generate_blog). Should use server-side secret injection via environment variables only, never as tool parameters.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Error messages are generic and non-actionable. 'エラー: ...' does not guide LLM recovery. Errors should suggest next steps (e.g., 'Invalid endpoint URL. Verify the FastAPI server is running and accessible.').