feat(keycardai-mcp): client implementation

Author: kamil-keycard

packages/mcp/README.md

@@ -101,6 +101,45 @@ uvicorn server:app
 - ✅ **Token Exchange**: Automatic delegated token exchange for accessing external APIs
 - ✅ **Production Ready**: Battle-tested security patterns and error handling
 
+## MCP Client
+
+The Keycard MCP SDK also includes **MCP Client** for connecting to MCP servers with built-in authentication support.
+
+### Key Features
+
+- ✅ **OAuth 2.0 Support**: Automatic OAuth flow handling for protected MCP servers
+- ✅ **AI Agent Integrations**: Pre-built integrations with LangChain and OpenAI Agents SDK
+
+### Quick Start
+
+```python
+import asyncio
+from keycardai.mcp.client import Client
+
+servers = {
+    "my-server": {
+        "url": "http://localhost:7878/mcp",
+        "transport": "http",
+        "auth": {"type": "oauth"}  # OAuth configured via server config
+    }
+}
+
+async def main():
+    async with Client(servers) as client:
+        # List available tools
+        tools = await client.list_tools()
+        
+        # Call a tool
+        result = await client.call_tool("my-tool", {"arg": "value"})
+        print(result)
+
+asyncio.run(main())
+```
+
+### Learn More
+
+For comprehensive documentation including use cases, configuration examples, and advanced patterns, see the [MCP Client README](src/keycardai/mcp/client/README.md).
+
 ### Delegated Access
 
 Keycard allows MCP servers to access other resources on behalf of users with automatic consent and secure token exchange.

packages/mcp/pyproject.toml

@@ -13,6 +13,8 @@ dependencies = [
     "httpx>=0.27.2",
     "starlette>=0.47.3",
     "nanoid>=2.0.0",
+    "aiohttp>=3.11.11",
+    "aiosqlite>=0.20.0",
 ]
 keywords = ["mcp", "model-context-protocol", "authentication", "authorization", "ai", "llm"]
 classifiers = [
@@ -36,6 +38,12 @@ test = [
     "pytest>=8.4.1",
     "pytest-asyncio>=1.1.0",
     "pytest-cov>=6.2.1",
+    "pytest-timeout>=2.3.1",
+    "fastmcp>=2.13.0",  # For integration tests
+    "keycardai-mcp-fastmcp",  # For integration tests
+    "openai-agents>=0.5.1",
+    "langchain>=1.0.5",
+    "langchain-openai>=1.0.2",
 ]
 
 [project.urls]
@@ -64,6 +72,7 @@ explicit = true
 
 [tool.uv.sources]
 keycardai-oauth = { workspace = true }
+keycardai-mcp-fastmcp = { workspace = true }
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/keycardai"]
@@ -115,6 +124,11 @@ exclude_also = [
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 addopts = "-ra -q"
+filterwarnings = [
+    # Ignore deprecation warnings from uvicorn/websockets (not our code)
+    "ignore::DeprecationWarning:websockets.*",
+    "ignore::DeprecationWarning:uvicorn.*",
+]
 
 [tool.commitizen]
 name = "cz_customize"