Simple MCP Server

🚀 📚 簡單的MCP信息服務器

這是一個基於FastMCP的微服務，藉助LangChain社區實用工具實現，為Wikipedia和Arxiv提供搜索工具。它能幫助用戶快速從這兩個平臺獲取所需信息，提升信息檢索效率。

🚀 快速開始

項目設置

先決條件

• Python 3.12或更高版本
• 安裝並配置好uv工具（用於運行MCP服務器）
• 安裝Claude Desktop（用於連接和測試）

初始化項目

1. 創建新項目：

   uv init simple_mcp_server
   cd simple_mcp_server
   

2. 激活虛擬環境：

   source env/bin/activate  # 對於Mac/Linux
   # 或者
   .\env\Scripts\activate  # 對於Windows
   

3. 安裝依賴項：

   pip install mcp[cli] langchain-community wikipedia arxiv
   

運行服務器

1. 啟動MCP服務器：

   uv run server.py
   

2. 配置Claude Desktop連接到此服務器。

配置Claude Desktop

編輯Claude Desktop的配置文件，添加以下內容：

"display": ":1"

啟動Claude Desktop並連接到MCP服務器。

✨ 主要特性

項目功能

此信息服務器通過MCP暴露了兩個工具：

1. get_info(searchterm: str) — 在Wikipedia上搜索簡短摘要
2. get_research_paper(searchterm: str) — 在Arxiv上獲取學術論文元數據

項目優勢

• 無需依賴Claude Desktop UI：可直接使用命令行工具。
• 易於替換LLM：支持多種語言模型，如Groq、OpenAI等。
• 完全控制交互流程：能自定義代理邏輯和工具調用順序。

📦 安裝指南

項目設置

先決條件

• Python 3.12或更高版本
• 安裝並配置好uv工具（用於運行MCP服務器）
• 安裝Claude Desktop（用於連接和測試）

初始化項目

1. 創建新項目：

   uv init simple_mcp_server
   cd simple_mcp_server
   

2. 激活虛擬環境：

   source env/bin/activate  # 對於Mac/Linux
   # 或者
   .\env\Scripts\activate  # 對於Windows
   

3. 安裝依賴項：

   pip install mcp[cli] langchain-community wikipedia arxiv
   

💻 使用示例

基礎用法

搜索Wikipedia

from langchain_community.wikipedia import WikipediaAPI

# 初始化Wikipedia API工具
wiki_tool = WikipediaAPI()

# 調用搜索功能
result = wiki_tool.search("Donald Trump")
print(result)

獲取學術論文

import arxiv

# 初始化Arxiv客戶端
client = arxiv.Client()

# 搜索論文
papers = client.search("AI in finance", max_results=5)
for paper in papers:
    print(paper.title, paperauthors))

高級用法

使用自定義MCP客戶端

import os
from langchain_community import wikipedia, arxiv

# 初始化Wikipedia和Arxiv工具
wiki_tool = WikipediaAPI()
arxiv_tool = arxiv.Client()

# 創建MCP代理
class MCPAgent:
    def __init__(self):
        self.tools = [wiki_tool, arxiv_tool]

    async def run(self, query):
        # 根據查詢選擇合適的工具
        if "Wikipedia" in query:
            return wiki_tool.search(query)
        else:
            return arxiv_tool.search(query)

# 初始化代理
agent = MCPAgent()

# 執行搜索任務
result = await agent.run("tell me about donald trump")
print(f"\n結果: {result}")

📚 詳細文檔

什麼是MCP？

模型控制協議（MCP） 是一種允許語言模型（如Claude）與外部工具（稱為“能力”）以標準方式進行通信的協議。這些能力可以是：

• 任何語言編寫的函數
• 網絡API
• 本地腳本

通過MCP，Claude可以調用您的工具、獲取響應，並繼續對話。

項目概述

此工具通過MCP暴露了兩個兼容的端點：

• get_info：在Wikipedia上搜索信息。
• get_research_paper：從Arxiv獲取學術論文的信息。

技術棧

• FastMCP：用於創建MCP服務器。
• LangChain社區工具包：用於與Wikipedia和Arxiv交互。
• Python 3.12+：項目運行的基礎語言。

🔧 技術細節

該項目演示瞭如何使用FastMCP創建一個MCP（模型上下文協議）服務器。它藉助FastMCP創建服務器，利用LangChain社區工具包實現與Wikipedia和Arxiv的交互。通過定義特定的工具函數，如get_info和get_research_paper，實現了信息的搜索和獲取。同時，通過自定義MCP代理，根據查詢內容選擇合適的工具進行搜索，實現了對交互流程的完全控制。

總結

該項目展示瞭如何通過FastMCP快速創建一個功能強大的信息檢索服務器。無論是用於個人研究還是企業應用，都可以根據需求靈活擴展和定製。