Mcp Sparql

io.github.daedalus由 GitHub 帳號 daedalus 發布v0.1.0更新於 Oct 25, 2026

MCP server exposing SPARQL query functionalities for LLMs

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓助理對 Wikidata 等 RDF 端點執行 SPARQL 查詢,並以表格或 JSON 回傳結果。

可以做什麼
對 SPARQL 端點執行 SELECT 查詢,回傳 Markdown 表格或 JSON,可設定逾時與資料列上限。執行 ASK 查詢取得真/假結果,執行 CONSTRUCT 或 DESCRIBE 查詢取得 Turtle 或 JSON-LD 格式的 RDF 三元組。在不執行的情況下驗證 SPARQL 語法。列出端點的具名圖並取得常用前綴,另提供標準命名空間前綴的內建資源。
適用情境
適合讓助理探索 Wikidata 等連結資料或 RDF 資料來源、檢查某個實體或事實是否存在,或在正式執行前草擬並驗證 SPARQL 語法。
執行需求
本機 Python 環境,從 PyPI 安裝 mcp-sparql 套件,以 stdio 程序啟動。需要能連線到所查詢的 SPARQL 端點;未宣告帳號或金鑰,但端點可能需要在每次呼叫時傳入 HTTP 標頭。
安裝前請注意
查詢會傳送到你指定的第三方 SPARQL 端點,查詢文字與提供的標頭都會傳給該主機。驗證標頭可依呼叫傳入,避免在查詢或日誌中暴露密鑰。大型或高成本查詢可能變慢或被端點限流;有資料列數與逾時限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Sparql,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mcp-sparql — MCP server exposing SPARQL query functionalities for LLMs.

[PyPI] [Python] [Ruff]

mcp-name: io.github.daedalus/mcp-sparql

Install

bash
pip install mcp-sparql

Usage

As an MCP Server

Add to your MCP configuration (e.g., ~/.config/claude/mcp.json):

json
{  "mcpServers": {    "mcp-sparql": {      "command": "mcp-sparql"    }  }}

Available Tools

ToolDescription
sparql_queryExecute SPARQL SELECT queries (table or JSON output)
sparql_askExecute SPARQL ASK queries (boolean result)
sparql_constructExecute SPARQL CONSTRUCT queries (Turtle or JSON-LD)
sparql_describeExecute SPARQL DESCRIBE queries (Turtle or JSON-LD)
sparql_validateValidate SPARQL query syntax without executing
sparql_list_graphsList named graphs on a SPARQL endpoint
sparql_get_prefixesGet common prefixes for a SPARQL endpoint

Examples

Query Wikidata:

sparql_query:  endpoint: "https://query.wikidata.org/sparql"  query: "SELECT ?item ?itemLabel WHERE { ?item wdt:P31 wd:Q5 . ?item rdfs:label ?itemLabel . FILTER(LANG(?itemLabel) = 'en') } LIMIT 5"

Check if an entity exists:

sparql_ask:  endpoint: "https://query.wikidata.org/sparql"  query: "ASK { wd:Q42 wdt:P31 wd:Q5 }"

Validate a query:

sparql_validate:  query: "SELECT ?s WHERE { ?s ?p ?o }"

List named graphs:

sparql_list_graphs:  endpoint: "https://query.wikidata.org/sparql"

Get common prefixes:

sparql_get_prefixes:  endpoint: "https://query.wikidata.org/sparql"

Resources

ResourceURIDescription
Common Prefixessparql://common-prefixesStandard SPARQL namespace prefixes

API

sparql_query

Execute a SPARQL SELECT query.

Parameters:

  • endpoint (str): SPARQL endpoint URL
  • query (str): SPARQL SELECT query
  • timeout (int, default=30): Query timeout in seconds
  • output_format (str, default="table"): "table" for Markdown, "json" for JSON
  • headers (dict, optional): HTTP headers for authentication
  • max_rows (int, default=1000): Maximum result rows

sparql_ask

Execute a SPARQL ASK query. Returns "true" or "false".

sparql_construct

Execute a SPARQL CONSTRUCT query. Returns RDF triples.

Additional parameters:

  • output_format (str, default="turtle"): "turtle" or "json"

sparql_describe

Execute a SPARQL DESCRIBE query. Returns RDF description.

sparql_validate

Validate SPARQL query syntax without executing.

sparql_list_graphs

List available named graphs on a SPARQL endpoint.

sparql_get_prefixes

Get commonly used prefixes for a SPARQL endpoint.

Development

bash
git clone https://github.com/daedalus/mcp-sparql.gitcd mcp-sparqlpip install -e ".[test]"
# run testspytest
# formatruff format src/ tests/
# lint + type checkprospector --with-tool ruff --with-tool mypy --with-tool pylint src/

來源:README.md,提交 093080a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分