Zenn MCP Server

Instructions

Implementation Reference

• src/mcp_server_zenn/server.py:223-226 (handler)

  Specific handler function for the 'article' tool. It converts the input arguments dictionary into an Article model instance and calls fetch_articles to retrieve data from Zenn.dev API.
  async def handle_articles(arguments: dict) -> dict: query = Article.from_arguments(arguments) return await fetch_articles(query)
• src/mcp_server_zenn/server.py:120-140 (schema)

  Defines the input schema for the 'article' tool using Pydantic model fields, returned as a Tool object for MCP registration.
  def tool() -> Tool: return Tool( name=ZennTool.ARTICLE.value, description="Fetch articles from Zenn.dev", inputSchema={ "type": "object", "properties": { "username": {"type": "string", "description": Article.model_fields["username"].description}, "topicname": {"type": "string", "description": Article.model_fields["topicname"].description}, "order": { "type": "string", "description": Article.model_fields["order"].description, "enum": [Order.LATEST.value, Order.OLDEST.value], }, "page": {"type": "integer", "description": Article.model_fields["page"].description}, "count": {"type": "integer", "description": Article.model_fields["count"].description}, }, "required": [], }, )
• src/mcp_server_zenn/server.py:243-246 (registration)

  Registers the 'article' tool with the MCP server by including its Tool schema in the list_tools response.
  @server.list_tools() async def list_tools() -> list[Tool]: return [Article.tool(), Book.tool()]
• src/mcp_server_zenn/server.py:248-268 (handler)

  Main MCP tool call handler decorated with @server.call_tool(). Dispatches 'article' tool calls to the specific handle_articles function and formats the JSON response as TextContent.
  @server.call_tool() async def call_tool( name: str, arguments: dict, ) -> Sequence[TextContent | ImageContent | EmbeddedResource]: try: logger.debug(f"Calling tool: {name} with arguments: {arguments}") match name: case ZennTool.ARTICLE.value: result = await handle_articles(arguments) case ZennTool.BOOK.value: result = await handle_books(arguments) case _: raise ValueError(f"Unknown tool: {name}") return [TextContent(type="text", text=json.dumps(result, indent=2, ensure_ascii=False))] except Exception as e: logger.error(f"Error processing {APP_NAME} query: {str(e)}") raise ValueError(f"Error processing {APP_NAME} query: {str(e)}")
• src/mcp_server_zenn/server.py:215-217 (helper)

  Helper function that performs the HTTP request to fetch articles from Zenn.dev API using the query parameters derived from the Article model.
  async def fetch_articles(query: Article) -> dict: return await request(URLResource.ARTICLES, query.to_query_param())