\u5982\u679c\u4f60\u7528\u8fc7 Claude\u3001Cursor \u8fd9\u7c7b AI \u5de5\u5177\uff0c\u80af\u5b9a\u9047\u5230\u8fc7\u8fd9\u6837\u7684\u573a\u666f\uff1a\u60f3\u8ba9 AI \u5e2e\u4f60\u5206\u6790\u4e00\u7bc7\u6700\u65b0\u7684\u6280\u672f\u6587\u7ae0\uff0c\u6216\u8005\u603b\u7ed3\u67d0\u4e2a\u4ea7\u54c1\u5b98\u7f51\u7684\u66f4\u65b0\u65e5\u5fd7\u3002\u4f60\u901a\u5e38\u600e\u4e48\u505a\uff1f\u624b\u52a8\u590d\u5236\u7c98\u8d34\u7f51\u9875\u5185\u5bb9\uff0c\u7136\u540e\u6254\u7ed9 AI\u3002\u8fd9\u4e2a\u8fc7\u7a0b\u4e0d\u4ec5\u7e41\u7410\uff0c\u9047\u5230\u957f\u6587\u7ae0\u8fd8\u5f97\u5206\u6bb5\u590d\u5236\uff0c\u66f4\u522b\u63d0\u7f51\u9875\u91cc\u90a3\u4e9b\u70e6\u4eba\u7684\u5e7f\u544a\u3001\u5bfc\u822a\u680f\u548c\u65e0\u5173\u4fe1\u606f\u4e86\uff0c\u5b83\u4eec\u4f1a\u4e25\u91cd\u5e72\u6270 AI \u7684\u7406\u89e3\u3002<\/p>\n
\u8fd9\u5c31\u662f MCP Fetch \u670d\u52a1\u5668\u8981\u89e3\u51b3\u7684\u75db\u70b9\u3002MCP\uff0c\u5168\u79f0 Model Context Protocol\uff0c\u4f60\u53ef\u4ee5\u628a\u5b83\u7406\u89e3\u4e3a AI \u5de5\u5177\u7684\u201c\u901a\u7528\u63d2\u5ea7\u201d\u3002\u5b83\u5b9a\u4e49\u4e86\u4e00\u5957\u6807\u51c6\u534f\u8bae\uff0c\u8ba9\u4e0d\u540c\u7684 AI \u5e94\u7528\uff08\u5ba2\u6237\u7aef\uff09\u80fd\u591f\u4ee5\u7edf\u4e00\u7684\u65b9\u5f0f\u8c03\u7528\u5916\u90e8\u5de5\u5177\uff08\u670d\u52a1\u5668\uff09\u3002\u800c Fetch \u670d\u52a1\u5668\uff0c\u5c31\u662f\u4e13\u95e8\u8d1f\u8d23\u201c\u4e0a\u7f51\u201d\u6293\u53d6\u5185\u5bb9\u7684\u90a3\u4e2a\u5de5\u5177\u3002<\/p>\n
\u81ea\u5df1\u52a8\u624b\u5b9e\u73b0\u4e00\u4e2a Fetch \u670d\u52a1\u5668\uff0c\u597d\u5904\u8fdc\u4e0d\u6b62\u662f\u201c\u4e0d\u7528\u518d\u590d\u5236\u7c98\u8d34\u201d\u8fd9\u4e48\u7b80\u5355\u3002\u9996\u5148\uff0c\u4f60\u83b7\u5f97\u4e86\u5b8c\u5168\u7684\u63a7\u5236\u6743\u3002\u4f60\u53ef\u4ee5\u5b9a\u5236\u5185\u5bb9\u6293\u53d6\u7684\u89c4\u5219\uff0c\u6bd4\u5982\u53ea\u6293\u53d6\u7279\u5b9a\u533a\u57df\u7684\u5185\u5bb9\uff0c\u6216\u8005\u5bf9\u6293\u53d6\u5230\u7684\u5185\u5bb9\u8fdb\u884c\u9884\u5904\u7406\u3002\u5176\u6b21\uff0c\u4f60\u80fd\u66f4\u597d\u5730\u63a7\u5236\u6210\u672c\u548c\u6027\u80fd\u3002\u4f7f\u7528\u7b2c\u4e09\u65b9 API \u5f80\u5f80\u6709\u6b21\u6570\u9650\u5236\u548c\u8d39\u7528\uff0c\u800c\u81ea\u5efa\u670d\u52a1\u5668\uff0c\u4f60\u53ef\u4ee5\u6839\u636e\u9700\u6c42\u914d\u7f6e\u4ee3\u7406\u6c60\u3001\u8fde\u63a5\u6c60\uff0c\u4f18\u5316\u6293\u53d6\u901f\u5ea6\u3002\u6700\u91cd\u8981\u7684\u662f\uff0c\u4f60\u80fd\u786e\u4fdd\u5408\u89c4\u6027\u3002\u4e00\u4e2a\u8d1f\u8d23\u4efb\u7684\u7f51\u7edc\u722c\u866b\u5fc5\u987b\u5c0a\u91cd\u7f51\u7ad9\u7684 robots.txt \u534f\u8bae\uff0c\u81ea\u5efa\u670d\u52a1\u5668\u8ba9\u4f60\u53ef\u4ee5\u7cbe\u7ec6\u5730\u63a7\u5236\u8fd9\u4e00\u884c\u4e3a\uff0c\u907f\u514d\u5bf9\u76ee\u6807\u7f51\u7ad9\u9020\u6210\u4e0d\u5fc5\u8981\u7684\u8d1f\u62c5\uff0c\u751a\u81f3\u5f15\u53d1\u6cd5\u5f8b\u98ce\u9669\u3002<\/p>\n
\u6211\u521a\u5f00\u59cb\u63a5\u89e6\u8fd9\u4e2a\u9700\u6c42\u65f6\uff0c\u4e5f\u5c1d\u8bd5\u8fc7\u4e00\u4e9b\u73b0\u6210\u7684\u65b9\u6848\uff0c\u4f46\u603b\u611f\u89c9\u4e0d\u591f\u987a\u624b\u3002\u8981\u4e48\u529f\u80fd\u592a\u7b80\u5355\uff0c\u8981\u4e48\u914d\u7f6e\u592a\u590d\u6742\u3002\u540e\u6765\u6211\u51b3\u5b9a\u81ea\u5df1\u5b9e\u73b0\u4e00\u4e2a\uff0c\u8e29\u8fc7\u4e0d\u5c11\u5751\uff0c\u4e5f\u79ef\u7d2f\u4e86\u5f88\u591a\u5b9e\u6218\u7ecf\u9a8c\u3002\u4eca\u5929\uff0c\u6211\u5c31\u628a\u8fd9\u4e9b\u4ece\u96f6\u5f00\u59cb\u6784\u5efa\u4e00\u4e2a\u5065\u58ee\u3001\u9ad8\u6548\u3001\u5408\u89c4\u7684 MCP Fetch \u670d\u52a1\u5668\u7684\u5b8c\u6574\u8fc7\u7a0b\u5206\u4eab\u7ed9\u4f60\uff0c\u5305\u542b\u5927\u91cf\u4f60\u5728\u5b98\u65b9\u6587\u6863\u91cc\u770b\u4e0d\u5230\u7684\u7ec6\u8282\u548c\u4f18\u5316\u6280\u5de7\u3002<\/p>\n
\u4e07\u4e8b\u5f00\u5934\u96be\uff0c\u4f46\u628a\u73af\u5883\u642d\u597d\uff0c\u540e\u9762\u5c31\u987a\u4e86\u3002\u6211\u4eec\u9009\u62e9 Python \u4f5c\u4e3a\u5b9e\u73b0\u8bed\u8a00\uff0c\u56e0\u4e3a\u5b83\u6709\u6781\u5176\u4e30\u5bcc\u7684\u7f51\u7edc\u722c\u866b\u548c\u6587\u672c\u5904\u7406\u751f\u6001\u3002\u6211\u4f1a\u5e26\u4f60\u4e00\u6b65\u6b65\u8d70\uff0c\u786e\u4fdd\u4f60\u7684\u5f00\u53d1\u73af\u5883\u662f\u5e72\u51c0\u4e14\u53ef\u590d\u73b0\u7684\u3002<\/p>\n
\u6211\u5f3a\u70c8\u5efa\u8bae\u4e3a\u6bcf\u4e2a\u9879\u76ee\u4f7f\u7528\u72ec\u7acb\u7684\u865a\u62df\u73af\u5883\uff0c\u8fd9\u80fd\u907f\u514d\u4f9d\u8d56\u5305\u4e4b\u95f4\u7684\u7248\u672c\u51b2\u7a81\u3002\u8fd9\u91cc\u6211\u7528 uv \u8fd9\u4e2a\u65b0\u5174\u7684\u5305\u7ba1\u7406\u5de5\u5177\uff0c\u5b83\u6bd4\u4f20\u7edf\u7684 pip \u5feb\u5f97\u591a\uff0c\u4e5f\u80fd\u5f88\u597d\u5730\u7ba1\u7406\u865a\u62df\u73af\u5883\u3002\u5982\u679c\u4f60\u8fd8\u6ca1\u5b89\u88c5\uff0c\u53ef\u4ee5\u7528 pip install uv \u6765\u83b7\u53d6\u3002<\/p>\n
# \u521b\u5efa\u9879\u76ee\u76ee\u5f55\u5e76\u8fdb\u5165
\nmkdir mcp-fetch-server
\ncd mcp-fetch-server<\/p>\n
# \u4f7f\u7528 uv \u521d\u59cb\u5316\u9879\u76ee\u5e76\u521b\u5efa\u865a\u62df\u73af\u5883
\nuv init
\nuv venv<\/p>\n
# \u6fc0\u6d3b\u865a\u62df\u73af\u5883
\n# \u5728 Windows \u4e0a\uff1a.venv\\\\Scripts\\\\activate
\n# \u5728 macOS\/Linux \u4e0a\uff1asource .venv\/bin\/activate<\/p>\n
\u6fc0\u6d3b\u865a\u62df\u73af\u5883\u540e\uff0c\u4f60\u7684\u547d\u4ee4\u884c\u63d0\u793a\u7b26\u524d\u9762\u901a\u5e38\u4f1a\u663e\u793a (.venv)\uff0c\u8fd9\u8868\u793a\u4f60\u5df2\u7ecf\u5728\u8fd9\u4e2a\u72ec\u7acb\u7684\u73af\u5883\u4e2d\u4e86\u3002<\/p>\n
\u6211\u4eec\u7684\u670d\u52a1\u5668\u6838\u5fc3\u4f9d\u8d56\u4ee5\u4e0b\u51e0\u4e2a\u5e93\uff0c\u5b83\u4eec\u5404\u6709\u5206\u5de5\uff1a<\/p>\n
\u4f7f\u7528 uv \u4e00\u6b21\u6027\u5b89\u88c5\u5b83\u4eec\uff1a<\/p>\n
uv add mcp httpx pydantic markdownify readabilipy<\/p>\n
\u5b89\u88c5\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a pyproject.toml \u6587\u4ef6\u6765\u6b63\u5f0f\u5b9a\u4e49\u6211\u4eec\u7684\u9879\u76ee\u3002\u8fd9\u4e2a\u6587\u4ef6\u5c31\u50cf\u662f\u9879\u76ee\u7684\u201c\u8eab\u4efd\u8bc1\u201d\u548c\u201c\u8bf4\u660e\u4e66\u201d\u3002<\/p>\n
# pyproject.toml
\n[project]
\nname = \\”mcp-fetch-server\\”
\nversion = \\”0.1.0\\”
\ndescription = \\”A custom MCP server for fetching and converting web content.\\”
\nreadme = \\”README.md\\”
\nrequires-python = \\”>=3.9\\”
\ndependencies = [
\n \\”mcp>=1.0.0\\”,
\n \\”httpx>=0.25.0\\”,
\n \\”pydantic>=2.0.0\\”,
\n \\”markdownify>=0.11.0\\”,
\n \\”readabilipy>=0.2.0\\”,
\n]<\/p>\n
[project.scripts]
\nfetch-server = \\”mcp_fetch_server.main:serve\\”<\/p>\n
\u6700\u540e\u4e00\u884c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u547d\u4ee4\u884c\u5165\u53e3\uff0c\u4ee5\u540e\u6211\u4eec\u53ef\u4ee5\u76f4\u63a5\u7528 fetch-server \u547d\u4ee4\u6765\u542f\u52a8\u670d\u52a1\uff0c\u975e\u5e38\u65b9\u4fbf\u3002<\/p>\n
\u5728\u5f00\u59cb\u5199\u7f51\u7edc\u8bf7\u6c42\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u5148\u5b9a\u4e49\u597d\u201c\u6e38\u620f\u89c4\u5219\u201d\u3002\u5ba2\u6237\u7aef\u4f1a\u4f20\u8fc7\u6765\u54ea\u4e9b\u53c2\u6570\uff1f\u6bcf\u4e2a\u53c2\u6570\u6709\u4ec0\u4e48\u8981\u6c42\uff1f\u8fd9\u4e00\u6b65\u505a\u5f97\u597d\uff0c\u80fd\u907f\u514d\u540e\u7eed\u5904\u7406\u4e2d\u5927\u91cf\u7684\u8fb9\u754c\u9519\u8bef\u548c\u5b89\u5168\u9690\u60a3\u3002Pydantic \u5e93\u5c31\u662f\u5e72\u8fd9\u4e2a\u7684\uff0c\u5b83\u901a\u8fc7\u7c7b\u578b\u6ce8\u89e3\u548c\u9a8c\u8bc1\u5668\uff0c\u8ba9\u53c2\u6570\u6821\u9a8c\u53d8\u5f97\u65e2\u4e25\u683c\u53c8\u4f18\u96c5\u3002<\/p>\n
\u6211\u4eec\u5b9a\u4e49\u4e00\u4e2a Fetch \u7c7b\uff0c\u5b83\u5bf9\u5e94\u5ba2\u6237\u7aef\u8c03\u7528 fetch \u5de5\u5177\u65f6\u4f20\u9012\u7684\u53c2\u6570\u3002\u6bcf\u4e2a\u5b57\u6bb5\u6211\u90fd\u52a0\u4e86\u8be6\u7ec6\u7684\u6ce8\u91ca\u548c\u9a8c\u8bc1\u89c4\u5219\u3002<\/p>\n
from pydantic import BaseModel, Field, AnyUrl, validator
\nfrom typing import Annotated
\nfrom urllib.parse import urlparse<\/p>\n
class Fetch(BaseModel):
\n \\”\\”\\”URL\u83b7\u53d6\u8bf7\u6c42\u7684\u53c2\u6570\u6a21\u578b\\”\\”\\”
\n url: Annotated[
\n AnyUrl,
\n Field(
\n description=\\”\u76ee\u6807URL\u5730\u5740\uff0c\u5fc5\u987b\u5305\u542b\u534f\u8bae\u5934\uff08\u5982 https:\/\/\uff09\\”,
\n examples=[\\”https:\/\/example.com\/article\\”]
\n )
\n ]
\n max_length: Annotated[
\n int,
\n Field(
\n default=5000,
\n ge=1,
\n le=1_000_000,
\n description=\\”\u8fd4\u56de\u5185\u5bb9\u7684\u6700\u5927\u5b57\u7b26\u6570\uff0c\u9632\u6b62\u5185\u5b58\u6ea2\u51fa\u3002\u6700\u5c0f1\uff0c\u6700\u5927100\u4e07\u3002\\”
\n )
\n ] = 5000
\n start_index: Annotated[
\n int,
\n Field(
\n default=0,
\n ge=0,
\n description=\\”\u5206\u9875\u83b7\u53d6\u7684\u8d77\u59cb\u5b57\u7b26\u7d22\u5f15\u3002\u4ece0\u5f00\u59cb\u8ba1\u6570\u3002\\”
\n )
\n ] = 0
\n raw: Annotated[
\n bool,
\n Field(
\n default=False,
\n description=\\”\u662f\u5426\u8fd4\u56de\u539f\u59cbHTML\u5185\u5bb9\u3002\u4e3aFalse\u65f6\uff0c\u4f1a\u81ea\u52a8\u8f6c\u6362\u4e3aMarkdown\u3002\\”
\n )
\n ] = False<\/p>\n
@validator(\\”url\\”)
\n def validate_url_scheme(cls, v):
\n \\”\\”\\”\u81ea\u5b9a\u4e49\u9a8c\u8bc1\u5668\uff1a\u786e\u4fddURL\u4f7f\u7528HTTP\u6216HTTPS\u534f\u8bae\\”\\”\\”
\n parsed = urlparse(str(v))
\n if parsed.scheme not in [\\”http\\”, \\”https\\”]:
\n raise ValueError(\\”URL\u534f\u8bae\u5fc5\u987b\u662f http \u6216 https\\”)
\n return v<\/p>\n
\u6211\u6765\u89e3\u91ca\u4e00\u4e0b\u51e0\u4e2a\u5173\u952e\u8bbe\u8ba1\u70b9\uff1a<\/p>\n
\u8fd9\u4e2a\u6a21\u578b\u4e0d\u4ec5\u4ec5\u662f\u4e2a\u201c\u6446\u8bbe\u201d\u3002\u5f53\u6211\u4eec\u5728\u670d\u52a1\u5668\u4e3b\u903b\u8f91\u4e2d\u63a5\u6536\u5230\u5ba2\u6237\u7aef\u4f20\u6765\u7684 JSON \u53c2\u6570\u65f6\uff0c\u53ef\u4ee5\u8fd9\u6837\u4f7f\u7528\uff1a<\/p>\n
try:
\n # \u8fd9\u884c\u4ee3\u7801\u4f1a\u81ea\u52a8\u89e6\u53d1\u6240\u6709\u5b57\u6bb5\u7684\u9a8c\u8bc1
\n fetch_args = Fetch(**arguments_from_client)
\nexcept ValidationError as e:
\n # \u5982\u679c\u9a8c\u8bc1\u5931\u8d25\uff0ce.errors() \u4f1a\u5305\u542b\u8be6\u7ec6\u7684\u9519\u8bef\u4fe1\u606f
\n return f\\”\u53c2\u6570\u9519\u8bef\uff1a{e.errors()[0][\\’msg\\’]}\\”<\/p>\n
\u8fd9\u6837\u4e00\u6765\uff0c\u4efb\u4f55\u975e\u6cd5\u7684\u3001\u8d85\u51fa\u8303\u56f4\u7684\u53c2\u6570\u90fd\u4f1a\u5728\u7b2c\u4e00\u65f6\u95f4\u88ab\u62e6\u622a\uff0c\u5e76\u8fd4\u56de\u6e05\u6670\u7684\u9519\u8bef\u4fe1\u606f\u7ed9\u5ba2\u6237\u7aef\u3002\u8fd9\u6bd4\u5728\u4e1a\u52a1\u903b\u8f91\u91cc\u5230\u5904\u5199 if \u5224\u65ad\u8981\u6e05\u723d\u548c\u53ef\u9760\u5f97\u591a\u3002\u6211\u5f3a\u70c8\u5efa\u8bae\u4f60\u5728\u4efb\u4f55\u6d89\u53ca\u5916\u90e8\u8f93\u5165\u7684\u5730\u65b9\u90fd\u4f7f\u7528 Pydantic \u6a21\u578b\uff0c\u8fd9\u662f\u5199\u51fa\u5065\u58ee\u4ee3\u7801\u7684\u597d\u4e60\u60ef\u3002<\/p>\n
\u53c2\u6570\u6821\u9a8c\u901a\u8fc7\u540e\uff0c\u5c31\u8fdb\u5165\u6700\u6838\u5fc3\u7684\u73af\u8282\uff1a\u4ece\u7f51\u7edc\u83b7\u53d6\u5185\u5bb9\u3002\u8fd9\u91cc\u6211\u4eec\u9009\u62e9 httpx \u7684\u5f02\u6b65\u5ba2\u6237\u7aef\uff0c\u56e0\u4e3a\u5b83\u80fd\u66f4\u597d\u5730\u5904\u7406\u5e76\u53d1\u8bf7\u6c42\uff0c\u4e0d\u4f1a\u5728\u7b49\u5f85\u7f51\u7edc\u54cd\u5e94\u65f6\u963b\u585e\u6574\u4e2a\u7a0b\u5e8f\u3002<\/p>\n
\u8fd9\u4e2a\u51fd\u6570\u662f\u670d\u52a1\u5668\u7684\u5fc3\u810f\uff0c\u5b83\u8d1f\u8d23\u53d1\u8d77 HTTP \u8bf7\u6c42\u3001\u5904\u7406\u5404\u79cd\u7f51\u7edc\u5f02\u5e38\u3001\u5224\u65ad\u5185\u5bb9\u7c7b\u578b\uff0c\u5e76\u51b3\u5b9a\u662f\u5426\u8fdb\u884c\u683c\u5f0f\u8f6c\u6362\u3002<\/p>\n
import asyncio
\nfrom httpx import AsyncClient, HTTPError, TimeoutException, ConnectError
\nfrom typing import Tuple
\nfrom mcp.shared.exceptions import McpError<\/p>\n
async def fetch_url(
\n url: str,
\n user_agent: str,
\n force_raw: bool = False,
\n proxy_url: str | None = None,
\n timeout: float = 30.0
\n) -> Tuple[str, str]:
\n \\”\\”\\”
\n \u5f02\u6b65\u6293\u53d6URL\u5185\u5bb9\u7684\u6838\u5fc3\u51fd\u6570\u3002<\/p>\n
\u53c2\u6570:
\n url: \u76ee\u6807\u5730\u5740
\n user_agent: \u7528\u6237\u4ee3\u7406\u5b57\u7b26\u4e32
\n force_raw: \u5f3a\u5236\u8fd4\u56de\u539f\u59cbHTML
\n proxy_url: \u4ee3\u7406\u670d\u52a1\u5668\u5730\u5740
\n timeout: \u8bf7\u6c42\u8d85\u65f6\u65f6\u95f4\uff08<\/p>\n","protected":false},"excerpt":{"rendered":"
1. \u4e3a\u4ec0\u4e48\u4f60\u9700\u8981\u4e00\u4e2a\u81ea\u5df1\u7684 MCP Fetch \u670d\u52a1\u5668\uff1f
\n\u5982\u679c\u4f60\u7528\u8fc7 Claude\u3001Cursor \u8fd9\u7c7b AI \u5de5\u5177\uff0c\u80af\u5b9a\u9047\u5230\u8fc7\u8fd9\u6837\u7684\u573a\u666f\uff1a\u60f3\u8ba9 AI \u5e2e\u4f60\u5206\u6790\u4e00\u7bc7\u6700\u65b0\u7684\u6280\u672f\u6587\u7ae0\uff0c\u6216\u8005\u603b\u7ed3\u67d0\u4e2a\u4ea7\u54c1\u5b98\u7f51\u7684\u66f4\u65b0\u65e5\u5fd7\u3002\u4f60\u901a\u5e38\u600e\u4e48\u505a\uff1f\u624b\u52a8\u590d\u5236\u7c98\u8d34\u7f51\u9875\u5185\u5bb9\uff0c\u7136\u540e\u6254\u7ed9 AI\u3002\u8fd9\u4e2a\u8fc7\u7a0b\u4e0d\u4ec5\u7e41\u7410\uff0c\u9047\u5230\u957f\u6587\u7ae0\u8fd8\u5f97\u5206\u6bb5\u590d\u5236\uff0c\u66f4\u522b\u63d0\u7f51\u9875\u91cc\u90a3\u4e9b\u70e6\u4eba\u7684\u5e7f\u544a\u3001\u5bfc\u822a\u680f\u548c\u65e0\u5173\u4fe1\u606f\u4e86\uff0c\u5b83\u4eec\u4f1a\u4e25\u91cd\u5e72\u6270 AI \u7684\u7406\u89e3\u3002
\n\u8fd9\u5c31\u662f MCP Fetch \u670d\u52a1\u5668\u8981\u89e3\u51b3\u7684\u75db\u70b9\u3002MCP\uff0c\u5168\u79f0 Model Context <\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[10323,10322,73,81],"topic":[],"class_list":["post-90661","post","type-post","status-publish","format-standard","hentry","category-server","tag-ai","tag-10322","tag-mcp","tag-python"],"yoast_head":"\n