mcp-server-12306
An MCP server that provides 12306 ticket query
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mcp-server-12306": {
"args": [
"mcp-server-12306@0.3.0"
],
"command": "uvx"
}
}
}可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数：query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数：urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数：url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数：url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数：input
服务介绍
馃殑 MCP Server 12306
鉁� 椤圭洰绠�浠�
MCP Server 12306鏄竴娆惧熀浜� Model Context Protocol (MCP) 鐨勯珮鎬ц兘鐏溅绁ㄦ煡璇㈠悗绔紝鏀寔瀹樻柟 12306 浣欑エ銆佺エ浠枫�佽溅绔欍�佺粡鍋溿�佹崲涔樻煡璇互鍙婃櫤鑳芥椂闂村伐鍏凤紝閫傞厤 AI/鑷姩鍖�/鏅鸿兘鍔╂墜绛夊満鏅�傜晫闈㈠弸濂斤紝鏄撲簬闆嗘垚锛屽紑绠卞嵆鐢ㄣ��
馃殌 鍔熻兘浜偣
- 瀹炴椂浣欑エ/杞︽/搴у腑/鏃跺埢/鎹箻涓�绔欏紡鏌ヨ
- 鍏ㄥ浗杞︾珯淇℃伅绠＄悊涓庢ā绯婃悳绱�
- 瀹樻柟缁忓仠绔欍�佷竴娆′腑杞柟妗堝叏鏀寔
- 瀹炴椂鏌ヨ鍚勮溅娆＄エ浠蜂俊鎭�
- 鏅鸿兘鏃堕棿宸ュ叿锛屾敮鎸佹椂鍖哄拰鏃堕棿鎴�
- Streamable HTTP/STDIO浼犺緭鍗忚锛屾敮鎸丮CP 2025-03-26鏍囧噯
- FastAPI寮傛楂樻�ц兘锛岀绾у搷搴�
- MCP鏍囧噯锛孉I/鑷姩鍖栧満鏅嵆鎻掑嵆鐢�
馃洜锔� 蹇�熶笂鎵�
鏈」鐩敮鎸佷袱绉嶈繍琛屾ā寮忥細
- Stdio 妯″紡锛氶�傜敤浜� Claude Desktop 绛夋湰鍦� MCP 瀹㈡埛绔紙鎺ㄨ崘锛夈��
- Streamable HTTP 妯″紡锛氶�傜敤浜庤繙绋嬮儴缃叉垨閫氳繃 SSE/Post 璁块棶銆�
妯″紡 1锛歋tdio 妯″紡锛圕laude Desktop 鎺ㄨ崘锛�
鍦ㄦ妯″紡涓嬶紝MCP Server 閫氳繃鏍囧噯杈撳叆/杈撳嚭涓庡鎴风閫氫俊锛屾棤闇�鍗犵敤缃戠粶绔彛銆�
鏂瑰紡 A锛氫娇鐢� uvx锛堟帹鑽愶級
uvx 鏄� uv 鍖呯鐞嗗櫒鎻愪緵鐨勫伐鍏凤紝鐜闅旂涓斿惎鍔ㄦ瀬蹇��
{
"mcpServers": {
"12306": {
"command": "uvx",
"args": ["mcp-server-12306"]
}
}
}
鏂瑰紡 B锛氫娇鐢� pipx
濡傛灉鎮ㄦ洿涔犳儻浣跨敤 pipx锛�
{
"mcpServers": {
"12306": {
"command": "pipx",
"args": ["run", "--no-cache", "mcp-server-12306"]
}
}
}
鏂瑰紡 C锛氭湰鍦版簮鐮佽繍琛�
閫傜敤浜庡紑鍙戣�呰皟璇曪細
{
"mcpServers": {
"12306": {
"command": "uv",
"args": ["run", "python", "-m", "mcp_12306.cli"],
"cwd": "/path/to/mcp-server-12306"
}
}
}
妯″紡 2锛歋treamable HTTP 妯″紡
鍦ㄦ妯″紡涓嬶紝Server 鍚姩涓�涓� Web 鏈嶅姟锛堥粯璁� 8000 绔彛锛夛紝鏀寔 MCP 鐨� SSE锛圫erver-Sent Events锛夊拰 POST 浜や簰銆�
鏂瑰紡 A锛氭湰鍦版簮鐮佽繍琛�
# 1. 鍏嬮殕骞跺畨瑁呬緷璧�
git clone https://github.com/drfccv/mcp-server-12306.git
cd mcp-server-12306
uv sync
# 2. 鍚姩鏈嶅姟鍣�
uv run python scripts/start_server.py
MCP 瀹㈡埛绔厤缃細
{
"mcpServers": {
"12306": {
"url": "http://localhost:8000/mcp"
}
}
}
鏂瑰紡 B锛欴ocker 閮ㄧ讲
# 鎷夊彇闀滃儚骞惰繍琛�
docker run -d -p 8000:8000 --name mcp-server-12306 drfccv/mcp-server-12306:latest
馃 宸ュ叿涓�瑙�
鏀寔鐨勪富娴佺▼宸ュ叿
| 宸ュ叿鍚� | 鍏稿瀷鍦烘櫙/鍔熻兘鎻忚堪 |
|---|---|
| query_tickets | 浣欑エ/杞︽/搴у腑/鏃跺埢涓�绔欏紡鏌ヨ |
| query_ticket_price | 瀹炴椂鏌ヨ鍚勮溅娆＄エ浠蜂俊鎭� |
| search_stations | 杞︾珯妯＄硦鎼滅储锛屾敮鎸佷腑鏂�/鎷奸煶/绠�鎷� |
| get_station_info | 鑾峰彇杞︾珯璇︽儏锛堝悕绉般�佷唬鐮併�佸湴鐞嗙瓑锛� |
| query_transfer | 涓�娆′腑杞崲涔樻柟妗堬紝鑷姩鎷兼帴鏈�浼樹腑杞� |
| get_train_route_stations | 鏌ヨ鎸囧畾鍒楄溅缁忓仠绔欏強鏃跺埢琛� |
| get_current_time | 鑾峰彇褰撳墠鏃堕棿涓庣浉瀵规棩鏈燂紝甯姪鐢ㄦ埛鍑嗙‘閫夋嫨鍑鸿鏃ユ湡 |
馃摎 宸ュ叿鏂囨。
鏈」鐩墍鏈変富娴佺▼宸ュ叿鐨勮缁嗗姛鑳姐�佸疄鐜颁笌浣跨敤鏂规硶锛屽潎宸叉敹褰曚簬 /docs 鐩綍涓嬶細
- query_tickets.md 鈥� 浣欑エ/杞︽/搴у腑/鏃跺埢涓�绔欏紡鏌ヨ
- query_ticket_price.md 鈥� 瀹炴椂鏌ヨ鍚勮溅娆＄エ浠蜂俊鎭�
- search_stations.md 鈥� 杞︾珯鏅鸿兘鎼滅储
- query_transfer.md 鈥� 涓�娆′腑杞崲涔樻柟妗�
- get_train_route_stations.md 鈥� 鏌ヨ鍒楄溅缁忓仠绔�
- get_current_time.md 鈥� 鑾峰彇褰撳墠鏃堕棿涓庣浉瀵规棩鏈�
姣忎釜鏂囨。鍖呭惈锛�
- 宸ュ叿鍔熻兘璇存槑
- 瀹炵幇鏂规硶
- 璇锋眰鍙傛暟涓庤繑鍥炵ず渚�
- 鍏稿瀷璋冪敤鏂瑰紡
濡傞渶浜屾寮�鍙戞垨闆嗘垚锛屽缓璁厛闃呰瀵瑰簲宸ュ叿鐨勬枃妗ｃ��
馃З 鐩綍缁撴瀯
src/mcp_12306/ # 涓绘簮浠ｇ爜
鈹溾攢 server.py # FastAPI涓诲叆鍙�
鈹溾攢 services/ # 涓氬姟閫昏緫锛堣溅绁�/杞︾珯/HTTP锛�
鈹溾攢 utils/ # 宸ュ叿涓庨厤缃�
scripts/ # 鍚姩涓庢暟鎹剼鏈�
馃搫 License
MIT License
鈿狅笍 鍏嶈矗澹版槑
- 鏈」鐩粎渚涘涔犮�佺爺绌朵笌鎶�鏈氦娴侊紝涓ョ鐢ㄤ簬浠讳綍鍟嗕笟鐢ㄩ�斻��
- 鏈」鐩笉瀛樺偍銆佷笉绡℃敼銆佷笉浼犳挱浠讳綍 12306 瀹樻柟鏁版嵁锛屼粎浣滀负瀹樻柟鍏紑鎺ュ彛鐨勬櫤鑳借仛鍚堜笌杞彂銆�
- 浣跨敤鏈」鐩�犳垚鐨勪换浣曞悗鏋滐紙鍖呮嫭浣嗕笉闄愪簬璐﹀彿灏佺銆佹暟鎹紓甯搞�佹硶寰嬮闄╃瓑锛夊潎鐢变娇鐢ㄨ�呮湰浜烘壙鎷咃紝椤圭洰浣滆�呬笉鎵挎媴浠讳綍璐ｄ换銆�
- 璇烽伒瀹堜腑鍥芥硶寰嬫硶瑙勫強 12306 瀹樻柟鐩稿叧瑙勫畾锛屽悎鐞嗗悎瑙勪娇鐢ㄣ��
