⚠️ 本內容完全屬於選讀。 您只需使用預建的 MCP 伺服器（GitHub、filesystem、Context7），就能高效地使用 Copilot CLI。本指南適合希望將 Copilot 連接到自訂內部 API 的開發者。詳情請參閱 MCP for Beginners 課程。
先決條件：
- 熟悉 Python
- 了解
async/await模式- 系統中已安裝
pip（本 dev container 中已包含）
想將 Copilot 連接到您自己的 API 嗎？以下是如何用 Python 建立一個簡單的 MCP 伺服器，以書籍資訊查詢為例，與本課程中一直使用的書籍應用程式相呼應。
mkdir book-lookup-mcp-server
cd book-lookup-mcp-server
pip install mcp
💡 什麼是
mcp套件？ 這是用於建立 MCP 伺服器的官方 Python SDK，負責處理協定細節，讓您專注於工具的開發。
建立一個名為 server.py 的檔案：
# server.py
import json
from mcp.server.fastmcp import FastMCP
# Create the MCP server
mcp = FastMCP("book-lookup")
# Sample book database (in a real server, this could query an API or database)
BOOKS_DB = {
"978-0-547-92822-7": {
"title": "The Hobbit",
"author": "J.R.R. Tolkien",
"year": 1937,
"genre": "Fantasy",
},
"978-0-451-52493-5": {
"title": "1984",
"author": "George Orwell",
"year": 1949,
"genre": "Dystopian Fiction",
},
"978-0-441-17271-9": {
"title": "Dune",
"author": "Frank Herbert",
"year": 1965,
"genre": "Science Fiction",
},
}
@mcp.tool()
def lookup_book(isbn: str) -> str:
"""Look up a book by its ISBN and return title, author, year, and genre."""
book = BOOKS_DB.get(isbn)
if book:
return json.dumps(book, indent=2)
return f"No book found with ISBN: {isbn}"
@mcp.tool()
def search_books(query: str) -> str:
"""Search for books by title or author. Returns all matching results."""
query_lower = query.lower()
results = [
{**book, "isbn": isbn}
for isbn, book in BOOKS_DB.items()
if query_lower in book["title"].lower()
or query_lower in book["author"].lower()
]
if results:
return json.dumps(results, indent=2)
return f"No books found matching: {query}"
@mcp.tool()
def list_all_books() -> str:
"""List all books in the database with their ISBNs."""
books_list = [
{"isbn": isbn, "title": book["title"], "author": book["author"]}
for isbn, book in BOOKS_DB.items()
]
return json.dumps(books_list, indent=2)
if __name__ == "__main__":
mcp.run()
各部分說明：
| 部分 | 作用 |
|---|---|
FastMCP("book-lookup") |
建立名為「book-lookup」的伺服器 |
@mcp.tool() |
將函式註冊為 Copilot 可呼叫的工具 |
| 型別提示 + docstring | 告訴 Copilot 每個工具的功能及所需參數 |
mcp.run() |
啟動伺服器並監聽請求 |
💡 為何使用裝飾器？
@mcp.tool()裝飾器就是您所需的全部。MCP SDK 會自動讀取函式的名稱、型別提示和 docstring 來產生工具綱要，無需手動撰寫 JSON 綱要！
將以下內容加入您的 ~/.copilot/mcp-config.json：
{
"mcpServers": {
"book-lookup": {
"type": "local",
"command": "python3",
"args": ["./book-lookup-mcp-server/server.py"],
"tools": ["*"]
}
}
}
copilot
> Look up the book with ISBN 978-0-547-92822-7
{
"title": "The Hobbit",
"author": "J.R.R. Tolkien",
"year": 1937,
"genre": "Fantasy"
}
> Search for books by Orwell
[
{
"title": "1984",
"author": "George Orwell",
"year": 1949,
"genre": "Dystopian Fiction",
"isbn": "978-0-451-52493-5"
}
]
> List all available books
[Shows all books in the database with ISBNs]
建立好基本伺服器後，您可以：
@mcp.tool() 函式都會成為 Copilot 可呼叫的工具BOOKS_DB 替換為實際的 API 呼叫或資料庫查詢pip 安裝